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内 容 简 介 


本 书 使 用 Android Studio 3. 0 开发 环境 ,同时 适 配 新 版 的 Android 8. 0 操作 系统 ,由 浅 入 深 地 学 习 Android 
App 的 开发 。 全 文 共 分 为 10 章 ， 涵 盖 Android Studio 的 开发 环境 搭建 、Android 控件 的 使 用 、 四 大 组 件 的 使 
用 、Fragment (碎片 》、 多 线程 开发 、 网 络 编程 与 数据 存储 等 内 容 。 最 后 通过 项 目 实战 ， 对 所 学 知识 点 融会 
贯通 ， 进 一 步 增 强 开发 能 力 。 
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可 作为 大 中 专 院 校 与 培训 机 构 的 培训 教程 。 
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我 在 写 书 之 前 一 直 在 CSDN 上 发 表 文 章 ， 同 时 在 “ 知 乎 ”等 网 站 回答 一 些 Android 相关 的 问 
题 ， 后 来 有 幸 收 到 了 清华 大 学 出 版 社 编辑 的 邀请 ， 于 是 产生 了 编写 本 书 的 想法 。 

我 最 早 是 从 事 Java Web 开发 的 ， 出 于 对 Android 的 浓厚 兴趣 ， 后 来 又 开始 从 事 Android 的 开 
发 。 在 开发 过 程 中 , 我 走 了 很 多 弯路 ,阅读 了 很 多 Android 方面 的 书 ， 从 入 门类 到 高 级 开发 类 都 有 ， 
美中不足 的 是 这 些 书 要 么 篇 幅 过 长 要 么 技术 过 时 ， 浪 费 了 很 多 时 间 。 鉴 于 此 ， 本 书 将 结合 我 多 年 的 
Android 开发 经 验 ， 总 结 企业 中 常用 的 开发 技术 ， 使 用 前 沿 技术 兼容 最 新 的 Android 操作 系统 ， 使 
初学 者 快速 加 入 Android 开发 阵营 。 即 使 是 中 、 高 级 开发 者 ， 阅 读本 书后 也 能 从 中 获 益 。 

Android 操作 系统 经 过 将 近 10 年 的 发 展 。 随 着 移动 App 的 热潮 ， 越 来 越 多 的 人 加 入 移动 开发 
的 大 军 ， 企 业 对 Android 招聘 的 需求 也 越 来 越 高 。 本 书 内 容 从 基础 入 门 到 高 级 开发 ， 涵 盖 企 业 开 发 
中 常用 的 技术 点 ， 能 让 读者 对 Android 开发 有 一 个 学 习 框架 。 最 后 一 章 通过 模仿 商业 App 开发 ， 
融会 贯通 前 面 的 知识 点 ， 以 提高 读者 项 目 开发 的 实战 能 力 。 


本 书 内 容 


本 书 共有 10 章 ， 主 要 内 容 如 下 : 

e@ 第 1 章 学 习 开发 工具 Android Studio 的 使 用 ， 一 个 好 的 开发 工具 可 以 大 大 提高 开发 人 员 的 
工作 效率 。 

@ 第 2 章 讲解 Android 控件 相关 知识 ， 一 个 UI 界面 由 多 个 控件 组 成 ， 只 有 熟练 使 用 各 种 控 
件 才 能 设计 出 好 看 的 App， 达 到 UI 设计 师 想 要 的 效果 。 

@ 第 3 章 学 习 Android 中 四 大 组 件 的 使 用 。 在 企业 的 项 目 开发 中 , 四 大 组 件 中 的 Activity ( 活 
动 )、Service (服务 )、Broadcast Receiver ( 广播 接收 器 ) 使 用 很 频繁 ，ContentProvider ( 内 
容 提供 者 ) 使 用 频率 相对 少 一 些 ， 只 有 某 些 特定 需求 时 才 会 用 到 。 

@ 第 4 章 学 习 Fragment (碎片 ) 的 使 用 方法 ， 从 Fragment 简单 使 用 到 最 后 的 案例 开发 ， 一 
步 步 深 入 地 学 习 Fragment。 使 用 Fragment 会 让 App 模块 化 ， 还 能 解决 手机 与 平板 电脑 的 
适 配 问题 。 

@ 第 5 章 学 习 多 线程 开发 .从 多 线程 的 创建 ,到 子 线程 如 何 更 新 UI, 通 过 阅读 源码 分 析 Handle 
的 实现 原理 ， 最 后 介绍 线程 池 的 使 用 方法 。 

@ 第 6 章 首先 学 习 Android 的 网 络 编程 ， 通 过 Get/Post 方式 向 服务 器 发 送 HTTP 请 求 。 现 在 
市 面 上 大 部 分 App 与 服务 器 交互 都 是 返回 Json 数据 ， 所 以 介绍 Gson 框架 ， 以 及 OkHttp 
开源 项 目的 使 用 和 封装 。 最 后 是 数据 存储 的 三 种 方式 。 

@ 第 7 章 学 习 Android 的 高 级 应 用 , 主要 介绍 Notification 使 用 、 多 媒体 开发 、WebView 使 用 、 
定位 的 三 种 方式 、NDK 和 JNI 开 发 、Git 管理 项 目 等 。 
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e@ 第 8 章 学 习 Android 中 各 大 版 本 的 更 新 ， 让 我 们 的 App 解决 版 本 适 配 问 题 ， 完 美 兼 容 5.0 
以 上 的 各 个 版 本 。 

@ 第 9 章 学 习 常 用 功能 模板 的 使 用 。 这 些 功能 是 企业 开发 中 可 能 会 碰 到 的 需求 ， 通 过 模板 的 
学 习 ， 知 道 如 何 对 一 个 App 进行 功能 划分 以 及 如 何 封 装 模 块 。 

日 第 10 章 通过 模仿 一 个 商业 App， 从 零 开 始 搭建 项 目 ， 使 用 前 面 9 章 所 学 的 内 容 ， 将 所 学 
知识 点 融会 贯通 ， 并 进一步 熟练 掌握 。 有 了 项 目 开 发 的 经 验 ， 你 在 今后 的 企业 开发 中 就 能 
快速 成 为 一 名 合格 的 开发 人 员 。 


本 书 特色 
本 书 定位 为 基础 类 图 书 ， 对 每 一 个 知识 点 的 讲解 都 很 详细 ， 从 基础 入 门 逐 步 进入 高 级 应 用 ， 
让 读者 能 系统 全 面 地 学 习 Android 开发 ， 更 深入 地 了 解 Android 开发 体系 。 本 书 的 内 容 是 我 多 年 


Android 开发 经 验 的 总 结 ， 也 是 一 个 合格 的 Android 开发 者 必须 掌握 的 内 容 ， 简 单 来 说 ， 就 是 企业 
开发 中 经 常用 到 的 技术 。 
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Android Studio 的 介绍 以 及 使 用 


孔子 云 : “ 工 欲 善 其 事 ， 必 先 利 其 器 ”。 一 个 好 的 开发 工具 可 以 让 开发 人 员 的 工作 效率 有 大 
幅度 的 提高 ， 本 章 主 要 学 习 Android Studio 的 使 用 。 以 前 都 是 用 Eclipse 开发 Android 程序 ， 自 从 
2013 年 Google 官方 发 布 了 Android Studio， 现 在 很 少 有 人 使 用 Eclipse 开发 Android 程序 了 。 本 书 
不 对 Eclipse 多 做 介绍 。 

Android Studio 是 Google 于 2013 年 IJO 大 会 针对 Android 开发 推出 的 新 开发 工具 ,是 基于 IntelliJ 
IDEA 开发 的 ，IntelliJ 在 业界 被 公认 为 最 好 的 Java 开发 工具 之 一 。 尤 其 是 在 智能 代码 助手 、 代 码 自 
动 提示 、 重 构 、J2EE 支持 、 各 类 版 本 工具 (Git、SVN、GitHub 等 ) 、JUnit、CVS 整合 、 代 码 分 
析 、 创 新 的 GUI 设计 等 方面 的 功能 ， 可 以 说 是 超常 的 。IDEA 是 JetBrains 公司 的 产品 ， 它 的 旗舰 
版 本 还 支持 HTML、CSS、PHP、MySQL、Python 等 ， 免 费 版 本 只 支持 Java 等 少数 语言 。 


1.1 探索 Android Studio 


Android Studio 是 基于 IntelliJl IDEA 的 官方 Android 应 用 集成 开发 环境 (IDE) 。 除 了 IntelliJ 
强大 的 代码 编辑 器 和 开发 者 工具 ，Android Studio 提供 了 更 多 可 提高 Android 应 用 构建 效率 的 功能 ， 
例如 : 
基于 Gradle 的 灵活 构建 系统 。 
快速 且 功 能 丰富 的 模拟 器 。 

可 针对 所 有 Android 设备 进行 开发 的 统一 环境 。 

Instant Run， 可 将 变更 推送 到 正在 运行 的 应 用 ， 无 须 构建 新 的 APK。 
帮助 构建 应 用 程序 和 导入 示例 代码 以 及 GitHub 集成 。 

丰富 的 测试 工具 和 框架 。 

可 捕捉 性 能 、 易 用 性 、 版 本 兼容 性 以 及 其 他 问题 的 Lint 工具 。 
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e@ Ct+ 和 NDK 支持。 
@ ”内置 对 Google 云端 平台 的 支持 ， 可 轻松 集成 Google Cloud Messaging 和 App 引擎 。 


1.1.1 项 目 结构 


Android Studio 中 的 每 个 项 目 包含 一 个 或 多 个 含有 源 代码 文 
件 和 资源 文件 的 模块 。 模 块 类 型 包括 : 

@ ”Android 应 用 模块 。 

ee ” 库 模块 。 

@ ”Google App 引擎 模块 。 


记忆 功 和 4 X 回 刘 急 和 急 ;4 
? 
android-RuntimePermissions-master “3 Appl| 
车 Android 到 名 直 炊 " ~ 
vv CaApplication 

™ Dmanifests 

辐 AndroldManifesLxml 
Y Djava 


重工 Project 


默认 情况 下 ，Android Studio 会 在 Android 项 目 视图 中 显示 | 和 ， 四 smearpleandrn 
项 目 文件 ， 如 图 1-1 所 示 。 该 视图 按 模块 组 织 结构 ， 便 于 快速 访 。 |3 ”Sa 
问 项 目的 关键 源 文件 。 -NE ou 

所 有 构建 文件 在 项 目 层次 结构 项 层 Gradle Scripts 下 显示 ， > mbm 


Y © Gradle Scripts 
D build.gradle (Proj 
5 build.gradle (Mod 
A gradle-wrapp' 
3 settings.gradle (Pr 
[local.properties (SDK L 


并 且 每 个 应 用 模块 都 包含 以 下 文件 夹 : 
e@ manifests: 包含 AndroidManifest.xml 文件 。 
@ java: 包含 Java 源 代 码 文件 ， 包 括 JUnit 测试 代码 。 
@ res: 包含 所 有 非 代码 资源 ， 例 如 XML 布局 、UI 字符 串 
和 位 图 图 像 。 


磁盘 上 的 Android 项 目 结构 与 此 扁平 项 目 结构 有 所 不 同 。 要 
查看 实际 的 项 目 文件 结构 ， 可 以 从 Project 下 拉 菜 单 在 图 1-1 ”图 1-1 Android 视图 中 的 项 目 文件 
中 显示 为 Android) 选择 Project。 

用 户 还 可 以 自 定义 项 目 文件 的 视图 ， 重 点 显示 应 用 开发 的 特定 方面 。 例 如 ， 选 择 项 目的 
Problems 视图 会 显示 指向 包含 任何 已 识别 编码 和 语法 错误 (如 布局 文件 中 缺少 一 个 XML 元 素 结束 
标记 ) 的 源 文件 链接 ， 如 图 1-2 所 示 。 









并 2: Favorites 





“3 android-RuntimePermissions-master > 了 Ap 
明 problems 介 站 | 妾 -有 
v CaApplication 
了 DApplication 
了 Dsrc/main 


‘#1: Project | 


AndroidManifest.xml 


«? 7: Structure 





图 1-2 项 目的 Problems 视图 
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1.1.2 Android Studio 主 窗口 
Android Studio 主 窗口 由 如 图 1-3 所 示 的 几 个 逻辑 区 域 组 成 。 


@oae Ww MainActivityjava - MyAppication - [~/AndroidStudioProjects/MyApglication] 
口上 多 YY 小 交 国 国人 外 | 人 人 app" 了 从小 避 入 国民 名 ?QQ 
C3 MyApplication ) Caapp ) DJ src ) D] main ’ DJ java ) 加 com ) 加 example ) EJ myapplication ， 由 MainActvity ) 








































图 | 而 Androd -名 直 | 次- |” @ MainActvityjava x 

elv Capp package com.example.myapplication; 

关 六 Dmanifests 

击 Y Djava +import ... 

> 加 com.example.myappll 四 public class MainActivity extends AppCompatActivity 

§ » com.example.myappll implenents NavigationView.OnNavigationItemSelectedListener { 

3 » com.example.myappli 

8 Ne eoverride 

A oi protected void onCreate(Bundle savedInstanceState) { savedInsta 

VI” © Gradle Scripts super,onCreate(SavedInstanceState); savedInstancestate: nuli| 
@ 他 build.gradle (Project: My/ SetContentView(R。Layout,activity_main); 

他 build.gradle (Module: ap Tootbar toolbar = (Toolbar) findViewById(R.id,toolbar); tooi 


or aper probentd setSupportActionBar(toolbar) ; 


目 proguard-rules.pro (ProC FloatingActionButton fab = (FloatingActionButton) findViewBy]| 
[gradle.properties (Project 时 fab. setOnClickListener( (OnClickListener) (view) = { 







app 妆 - 二 
Debugger | 国 cConsole 之 竹 王 兰 Y 站 耳光 半 四 晶 
<| ll Frames "过 variables ~ 加 watches a 





Le 也 "ma. 回 + 4 YF ” Sthis= {MainActivity@4567} 


三 savedInstancestate = null 
onCreate:24, MainActivi No watches 


@ | perfomcreate:6237. A 县 toolbar = {Toolbar@4570) "android.support.v7... View 
performCreate:6237, Act 


callActivityOnCreate:110 
| performLaunchActivity:2 











lapow plolpuY 名 


handleLaunchActivity:24| 


+ 一 ^v 回 





闻 0: Messages ” 国 Termnal 党 6Androd Monitor 耻 4Run 莉 
四 五 Can't bind to local 8700 for debugger (2 minutes ago) 24:1 LF: UTF-8: Context <no context> be 


1-3 Android Studio 主 窗口 








Q@ 工具 栏 ， 提 供 执行 各 种 操作 的 工具 ， 包 括 运行 应 用 和 启动 Android 工具 。 

@ 导航 栏 ， 可 以 帮助 在 项 目 中 导航 ， 以 及 打开 文件 进行 编辑 。 此 区 域 提 供 Project 窗口 所 示 结 
构 的 精简 视图 。 

@ 编辑 器 窗口 ， 是 创建 和 修改 代码 的 区 域 。 编 辑 器 可 能 因 当 前 文件 类 型 的 不 同 而 有 所 差异 。 
例如 ， 在 查看 布局 文件 时 ， 编 辑 器 显示 布局 编辑 器 。 

@ 工具 窗口 栏 ， 在 IDE 窗口 外 部 运行 ， 并 且 包 含 可 用 于 展开 或 折 邯 各 个 工具 窗口 的 按钮 。 

@ 工具 窗口 ， 提 供 对 特定 任务 的 访问 ， 例 如 项 目 管理 、 搜 索 和 版 本 控制 等 。 可 以 展开 和 折 秋 
这 些 窗口 。 

@ 状态 栏 ， 显 示 项 目 和 IDE 本 身 的 状态 以 及 任何 警告 或 消息 。 

用 户 可 以 通过 隐藏 或 移动 工具 栏 和 工具 窗口 调整 主 窗口 ， 以 便 留 出 更 多 屏幕 空间 ， 还 可 以 使 
用 键盘 快捷 键 访问 大 多 数 IDE 功能 。 

可 以 随时 通过 按 两 下 Shift 键 或 点 击 Android Studio 窗口 右上 角 的 放大 镜 搜索 源 代码 、 数据 库 、 
操作 和 用 户 界面 的 元 素 等 。 此 功能 非常 实用 ， 例 如 在 忘记 如 何 触发 特定 IDE 操作 时 ， 可 以 利用 此 
功能 进行 查找 。 
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1.1.3 ”工具 窗口 


Android Studio 不 使 用 默认 窗口 , 而 是 根据 情境 在 工作 时 自动 显示 相关 工具 窗口 。 默认 情 况 下 ， 
最 常用 的 工具 窗口 固定 在 应 用 窗口 边缘 的 工具 窗口 栏 上 。 

@ 要 展开 或 折 营 工具 窗口 ， 请 在 工具 窗口 栏 中 点 击 该 工具 的 名 称 ， 还 可 以 拖 动 、 固 定 、 取 消 固 
定 、 关 联 和 分 离 工 具 窗 口 。 

@ 要 返回 当前 默认 工具 窗口 布局 ， 请 点 击 Window 一 Restore Default Layout 或 点 击 Window 一 
Store Current Layout as Default 自 定 义 默 认 布局 。 

@ 要 显示 或 隐藏 整个 工具 窗口 栏 ， 请 点 击 Android Studio 窗口 左下 角 的 窗口 图 标 。 

@ 要 找到 特定 工具 窗口 ， 请 将 所 标 指针 是 停 在 窗口 图 标 上 方 ， 并 从 菜单 选择 相应 的 工具 窗口 。 


还 可 以 使 用 键盘 快捷 键 打开 工具 窗口 。 表 1-1 列 出 了 最 常用 的 窗口 快捷 键 。 
表 1-1 部 分 实用 工具 窗口 的 键盘 快捷 键 





REE Windows 和 Linux 
FT 


[pemg |shintr9 
Android Monitor 


Retum to Editor lee ee 


Hide All Tool Windows Ctrl+Shift+F12 Command+ShifttF12 


如 果 想 要 隐藏 所 有 工具 栏 、 工 具 窗口 和 编辑 器 选项 卡 ， 请 点 击 View 一 Enter Distraction Free 
Mode。 此 操作 可 启用 无 干扰 模式 。 要 退出 “无 干扰 模式 ”, 请 点 击 View 一 Exit Distraction Free Mode。 

用 户 可 以 使 用 快速 搜索 在 Android Studio 中 的 大 多 数 工 具 窗 口中 执行 搜索 和 入 选 。 要 使 用 快速 
搜索 ， 请 选择 工具 窗口 ， 然 后 输入 搜索 查询 。 





1.1.4 代码 自动 完成 


Android Studio 有 三 种 自动 补 全 代码 快捷 键 ， 如 表 1-2 所 示 。 
表 1-2 代码 自动 完成 的 键盘 快捷 键 








类 型 说 明 Windows 和 Linux Mac 
基本 自动 | 显示 对 变量 、 类 型 、 方 法 和 表达 式 等 的 | Ctrlt 空 格 ControHt 空 格 
完成 基本 建议 。 如 果 连 续 两 次 调用 基本 自动 


完成 , 将 显示 更 多 结果 ,包括 私有 成 员 
和 非 导入 静态 成 员 
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( 续 表 ) 

类 型 说 明 Windows 和 Linux Mac 
智能 自动 | 根据 上 下 文 显示 相关 选项 . 智能 自动 完 | CurltShiftt 空 格 Control+Shiftt+ 空 格 
完成 成 可 识别 预期 类 型 和 数据 流 。 如 果 连 续 

两 次 调用 智能 自动 完成 , 将 显示 更 多 结 

果 ， 包 括 链 
语句 自动 | 自动 完成 当前 语句 ， 添 加 缺失 的 圆 括 | Cul+ShifttEnter ShiftHCommand+Enter 
完成 号 、 大 括号 、 花 括号 和 格式 化 等 











还 可 以 按 AlttEnter 组 合 键 执行 快速 修复 并 显示 建议 的 操作 。 


1.1.5 样式 和 格式 化 


在 编辑 时 ，Android Studio 将 自动 应 用 代码 样式 设置 中 指定 的 格式 设置 和 样式 。 可 以 通过 编程 
语言 自 定义 代码 样式 设置 ,包括 指定 选项 卡 和 缩 进 、 空 格 、 换 行 、 花 括号 以 及 空白 行 的 约定 。 要 自 
定义 代码 样式 设置 ， 请 点 击 File 一 Settings 一 Editor 一 Code Style (在 Mac 上 ， 点 击 Android Studio 
一 Preferences 一 Editor 一 Code Style) 。 

IDE 会 在 你 写 代码 时 自动 对 代码 进行 格式 化 ， 也 可 以 通过 按 快 捷 键 CtrH+AlttL (在 Mac 上 ， 
按 OptrCommand+L) 格式 化 代码 、 按 快捷 键 Ctrl+Alt+I (在 Mac 上 ， 按 AlttOption+I*) 自动 缩 
进 所 有 行 。 图 1-4 (Ca) 是 格式 化 之 前 的 代码 ， 图 1-4 (b) 是 格式 化 之 后 的 代码 。 


public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R, layout.activity main); 
mActionBar = getSupportActionBar(); 
mActionBar. setDisplayHomeAsUpEnabled (true); 


public void onCreate(Bundle savedInstanceState) { 
super,.onCreate(savedInstanceState); 
setContentView(R,. layout .activity_main); 
mActionBar = getSupportActionBar(); 
mActionBar. setDisplayHomeAslloFnablrN(true): 
Formatted 7 lines 
Show reformat dialog: 愉 介 嘴 ! 
// Get reference to tn 2 r T 





(b) 


14-2 格式 化 前 后 的 代码 


1.1.6 版 本 控制 基础 知识 


Android Studio 支持 多 个 版 本 控制 系统 (VCS) , 包括 Git、 GitHub、CVS、Mercurial、 Subversion 
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和 Google Cloud Source Repositories。 

在 将 应 用 导入 Android Studio 后 ， 使 用 Android Studio VCS 菜单 选项 启用 对 所 需 版 本 控制 系 
统 的 VCS 支持 、 创 建 存储 库 、 导 入 新 文件 至 版 本 控制 以 及 执行 其 他 版 本 控制 操作 : 

@ 在 Android Studio VCS 菜单 中 点 击 Enable Version Control Integration 。 

@ 从 下 拉 菜 单 中 选择 要 与 项 目 根 目 录 关 联 的 版 本 控制 系统 ， 然 后 点 击 OK 按钮 。 


此 时 ，VCS 菜单 将 根据 选择 的 系统 显示 多 个 版 本 控制 选项 。 


还 可 以 使 用 File 一 Settings 一 Version Control 菜单 选项 设置 和 修改 版 本 控制 设置 。 





1.1.7 ”Gradle 构建 系统 


Android Studio 基于 Gradle 构建 系统 ， 并 通过 适用 于 Gradle 的 Android 插件 提供 更 多 面向 
Android 的 功能 。 该 构建 系统 可 以 作为 集成 工具 从 Android Studio 菜单 运行 ， 还 可 以 从 命令 行 独立 
运行 。 

可 以 利用 构建 系统 的 功能 执行 以 下 操作 : 

@ 自 定义 、 配 置 和 扩展 构建 流程 。 

”使 用 相同 的 项 目 和 模块 为 用 户 的 应 用 创建 多 个 具有 不 同 功 能 的 APK。 

@ 在 不 同 源 代码 集 之 间 重 复 使 用 代码 和 资源 。 


利用 Gradle 的 灵活 性 ， 可 以 在 不 修改 应 用 核心 源 文件 的 情况 下 实现 以 上 所 有 目的 。Android 
Studio 构建 文件 以 build.gradle 命名 。 

这 些 文件 是 纯 文 本 文件 , 使 用 适用 于 Gradle 的 Android 插件 提供 的 元 素 以 Groovy 语法 配置 构 
建 。 

每 个 项 目 有 一 个 用 于 整个 项 目的 顶级 构建 文件 ， 以 及 用 于 各 模块 的 单独 的 模块 层级 构建 文件 。 
在 导入 现 有 项 目 时 ，Android Studio 会 自动 生成 必要 的 构建 文件 。 


1.1.8 ”Debug 调试 


使 用 Debug 调试 功能 在 调试 程序 视图 中 对 引用 、 表 达 式 和 变量 值 进行 内 联 验证 ， 提 高 代码 检 
查 效率 ， 如 图 1-5 所 示 。Debug 调试 信息 包括 : 
变量 值 
引用 某 选 定 对 象 的 引用 对 象 
方法 返回 值 
Lambda 和 运算 符 表达 式 
工具 提示 什 
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Goverride 

ef public boolean onCreate0ptionsMenu(Menu menu) { menu: MenuBuilder@4312 
// Inflate our menu from the resources by Us 

© BT 












// It is also possible add items here. Use a generated id from 
// resources (ids.xml) to ensure that alL menu ids are distinct. 
MenuItem locationItem = menu.add(0, R.id.menu_location, 0, "Location"); 
locationItem. setIcon(R.drawable.ic_action_location); 


图 1-5 内 联 变量 值 





要 启用 Debug 调试 ， 请 在 Debug 窗口 中 点 击 Settings， 然 后 选中 Show Values Inline 复 选 框 。 


1.1.9 性 能 监视 器 


Android Studio 提供 性 能 监视 器 , 让 用 户 可 以 更 加 轻松 地 跟踪 应 用 的 内 存 和 CPU 使 用 情况 、 查 
找 已 解除 内 存 分 配 的 对 象 、 查 找 内 存 泄漏 以 及 优化 图 形 性 能 和 分 析 网 络 请 求 。 
在 设备 或 模拟 器 上 运行 应 用 时 ， 打 开 Android Monitor 工具 窗口 ， 然 后 点 击 Monitors 标签 。 


1.1.10 ”分配 跟踪 器 


Android Studio 允许 在 监视 内 存 使 用 情况 的 同时 跟踪 内 存 分 配 情 况 。 利 用 跟踪 内 存 分 配 功能 ， 
可 以 在 执行 某 些 操作 时 监视 对 象 被 分 配 到 哪些 位 置 。 了 解 这 些 分 配 后 , 就 可 以 相应 地 调整 与 这 些 操 
作 相 关 的 方法 调用 ， 从 而 优化 应 用 的 性 能 和 内 存 使 用 。 


1.1.11 数据 文件 访问 


Systrace、logcat 和 Traceview 等 Android SDK 工具 可 生成 性 能 和 调试 数据 , 用 于 对 应 用 进行 详 
细 分 析 。 

要 查看 已 生成 的 数据 文件 ， 请 打开 Captures 工具 窗口 。 在 已 生成 的 文件 列表 中 ， 双 击 相应 的 
文件 即 可 查看 数据 。 右 击 任何 .hprof 文件 ， 即 可 将 其 转换 为 标准 .hprof 文件 格式 。 


1.1.12 ”代码 检查 


在 每 次 编译 程序 时 ，Android Studio 都 将 自动 运行 已 配置 的 Lint 及 其 他 IDE 检查 , 帮助 轻松 识 
别 和 纠正 代码 结构 质量 问题 。 

Lint 工具 可 检查 你 的 Android 项 目 源 文件 是 否 有 潜在 的 错误 ， 以 及 在 正确 性 、 安 全 性 、 性 能 、 
可 用 性 、 无 障碍 性 和 国际 化 方面 是 否 需 要 优化 改进 ， 如 图 1-6 所 示 。 
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Inspection Results for Inspection Profile 'Project Default 章 - 鞋 
py 回 Y ® DrawerNavigation (37 items) Name 
x BY Android> Lint> Accessibility (1 item) i ca 
ER Y 凤 Image without contentDescription (1 item) Wn 
Ei v Dapp (1 item) file .../app/src/main/res/layout/fragment p 
EE er ve lanet.xml - [app] 
i pb Android > Lint > Correctness (5 items) : 
人 县 人 Problem synopsis 
上 Android > Lint > Internationalization > Bidirec [Accessibility] Missing contentDescription 
ba pb Android > Lint > Performance (9 items) attribute on image (at line 17) 
出 时 上 Android > Lint > Security (1 item) 
加 县 。 上 Android > Lint > Usability (1 Item) a 
Ey > Android > Lint > Usability > lcons (9 ltems) 
这 bs Nerlaratinn redundanny (7 Neme) uppress with @SuppressLint (Java) or 








+amlesinnmre [LYM 


1-6 Android Studio 中 Lint 检查 的 结果 
除了 Lint 检查 ,Android Studio 还 可 以 执行 IntelliJ 代码 检查 和 注解 验证 ,以 简化 编码 工作 流程 。 


1.1.13 ”日志 消息 


在 使 用 Android Studio 构建 和 运行 应 用 时 ， 点 击 窗口 底部 的 Android Monitor 查看 adb 输出 和 
设备 日 志 消 息 (logcat)。 


1.2 下载 与 安装 Android Studio 


在 下 载 Android Studio 之 前 , 需要 先 安装 Java 语言 的 软件 开发 工具 包 JDK, 因为 Android 是 基 
于 Java 语言 的 ， 并 且 所 有 的 App 都 是 在 Java 虚拟 机 上 运行 的 。 

Oracle 官网 下 载 地 址 为 http://www.oracle.com/technetwork/java/javase/downloads/idk8-downloads- 
2133151.html 。 

上 面 这 个 链接 可 以 下 载 各 个 操作 系统 的 oracle jdk1.8 版 本 ， 例 如 笔者 的 电脑 是 Mac 系统 ， 具 体 下 
载 地 址 为 http://download.oracle.com/otn-pub/java/jdk/8u144-b01/090f390dda5b47b9b721c7dfaa008135/ 
jdk-8u144-macosx-x64.dmsg。 


1.2.1 下 载 Android Studio 


以 前 下 载 Android Studio 还 需要 科学 上 网 ,或 者 国内 的 镜像 地 址 下 载 ,2016 年 12 月 8 日 Google 
Developers 中 国 网 站 (developers.google.cn〉 正式 发 布 。 

Google Developers 中 国 网 站 是 特别 为 中 国 开发 者 而 建立 的 ， 汇 集 了 Google 为 全 球 开发 者 所 提 
供 的 开发 技术 资源 ， 包 括 API 文档 、 开 发 案例 、 技 术 培 训 的 视频 。 

不 需要 科学 上 网 的 官方 下 载 Android Studio 地 址 为 https://developer.android.google.cn/studio/ 
index.html 。 

打开 地 址 首页 ， 如 图 1-7 所 示 。 
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于 Android Studio 
官方 Android IDE 





下 二 avoaolo Sry0%o 
TaMag 483 MI 
》 阅读 文档 。。》 坦 看 版 本 说 明 


图 1-7 下 载 主页 


它 会 自动 识别 用 户 的 操作 系统 ， 例 如 笔者 的 电脑 是 Mac， 所 以 那个 下 载 的 按钮 上 就 有 FOR 
MAC 版 本 ， 直 接点 击 “ 下 载 ANDROID STUDIO” 按 钮 即 可 。 


1.2.2 ”开始 安装 


安装 Android Studio 的 方法 如 下 : 


步骤 01 和 双击 打开 下 载 的 Android Studio 的 安装 包 ， 将 左 侧 的 Android Studio 图 标 拖 到 右 侧 ， 
如 图 1-8 所 示 。 


= Android Studio 2.3.3 


Alellelie 
ole 


* 入 
严 


Da 


Android Studio.app Applications 





图 1-8 Android Studio 安装 





步 又 024 在 应 用 列表 ( Launchpad ) 中 打开 Android Studio， 进 入 如 图 1-9 所 示 的 设置 界面 ， 
中 有 两 个 选项 。 


























@ ”第 一 个 选项 是 如 果 之 前 使 用 过 Android Studio， 可 以 导入 之 前 的 配置 文件 。 
@ 第 二 个 选项 是 默认 的 ， 之 前 没有 安装 过 Android Studio 或 者 我 不 想 导 入 之 前 的 配置 。 
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一 般 情 况 用 第 二 个 选项 〈 默 认 ) 就 行 ， 点 击 OK 按钮 。 
© Complete Installation 


You can import your settings from a previous version of Studio. 


~ ) | want to import my settings from a custom location 


Specify config folder or installation home of the previous version of Studio: 


/Applications 


© | do not have a previous version of Studio or | do not want to import my settings 


图 1-9 设置 界面 
步骤 03Q 进入 设置 代理 界面 ， 如 图 1-10 所 示 。 
‘®@o.@ Android Studio First Run 


es Unable to access Android SDK add-on list 


spov ED 


1-10 设置 代理 


步 最 044 如 果 无 法 访问 Android SDK 列表 ， 这 时 会 弹出 一 个 设置 代理 的 提示 对 话 框 。 我 们 不 
需要 设置 ， 直 接点 击 Cancel 按钮 ， 进 入 欢迎 界面 ， 如 图 1-11 所 示 。 


oe Android Studio Setup Wizard 


Welcome 


pe woodsuao 


Welcomel This wizard will set up your development environment for Android Studio. 
Additionally, the wizard will help port existing Androld apps Into Androld Studio 


or create a new Android application project. 


D9 Cl 


Cancal Previo 


图 1-11 欢迎 界面 
步骤 05 在 欢迎 界面 直接 点 击 Next 按钮 , 选择 安装 类 型 ,如 








图 








1-12 所 示 , 直接 选择 “Standard 





(标准 》 选项， 点 击 Next 按钮 。 
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one Android Studio Setup Wizard 


yx Install Type 


Choose the type of setup you want for Android Studio: 


人 standard 


Android Studio will be installed with the most common sertings and options. 
Recommended for most users. 


Custom 
You can customize installation settings and components installed. 


Cancel Previous TT rm 
图 1-12 ”安装 类 型 


步骤 06 选择 安装 类 型 之 后 进入 SDK 组 件 下 载 列表 界面 ， 如 图 1-13 所 示 ， 直 接点 击 Finish 


按钮 。 


oe Android Studio Setup Wizard 





zx Verify Settings 


If you want to revlew or change any of your installation settings, click Prevlous. 


Current Sertings: 
899 MB 
SDK Components to Download: 
Androld Emulator 102 MB 
Android SDK Build-Tools 26.0.2 51.3 MB 
Android SDK Platform 26 60.7 MB 
Androld SDK Platform-Tools 7.5 MB 
Android SDK Tools 98.2 MB 
Android Support Repository 339 MB 
Google Repository 205 MB 
Intel x86 Emulator Accelerator (HAXM installer) 。 217 KB 
SDK Patch Applier v4 174 MB 
Sources for Android 26 33.5 MB 





Cancel Previous = next 2 
图 1-13 下 载 组 件 
步骤 074 下 载 SDK 组 件 中 ， 如 图 1-14 所 示 。 
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eae Android Studio Setup Wizard 


zx Downloading Components 





Downloading... 





mrepos1tory/con/anoroio/oatad0inging/ UDrary/1.0-rc2/ UDrary-1.Y-rc2-sources. Jar. m0y 
mrepository/com/android/databinding/tibrary/1.9-rC2/tibrary-1.8-rc2-javadoc,jarvshal 
mrepository/cCom/android/databinding/tibrary/1.8-rC2/tibrary-1.8-rc2-javadoc.jar.ad5 
mrepository/com/android/databinding/tibrary/1.8-rc2/tibrary-1.8-rc2.aarvpd5 
mrepository/comyandroid/databinding/tibrary/1.8-rc2/tibrary-1.8-rc2-sSources.jar.shal 
mrepository/comyandrold/databindingytibrary/1.9-rc2/tibrary-1.8-rc2.aar,shal 
mrepository/com/android/databinding/tibrary/1.8-rc2/tibrary-1.8-rc2.pom.shal 
m2repository/con/android/databinding/Uibrary, -rc2-javadoc. jar 
m2repository/con/android/datadinding/\ibrary, 0-rc2,aar 
m2repository/con/android/databinding/ Uibrary, -rc2-sources, jar 
m2repository/con/android/databinding/ Vibrary/1,8-rc2/Library-1.0-rc2,pom.md5 
mrepository/source.properties 

"Instatl Android Support Repository (revision: 47.9.9)”ready， 
Finishing “Install Android Support Repository (revision: 4 
Installing Android Support Repository in 














LUsers/opple/Library/Androld/sdu/extras/android/s2repository 
7.0.0)" complete, 


vInstall Android Support Repository (revisio 
WINStaUt Androld Support Revository (revision: 478. 
Preparing “Install Android SDK Build-Tools 21 
Downtoading https://dl,google.con/android/repository/build-tools_r26,0, 
https://dl,.goog\e, con/android/repository/build-tools_r26,8.2-nacosx,zip 








图 1-14 下 载 中 


步骤 08A 下 载 这 么 多 组 件 肯定 需要 一 些 时 间 ， 等 待 下 载 完 成 直接 点 击 Finish 按钮 。 接 下 来 进 
入 Android Studio 主页 ， 如 果 1-15 所 示 ， 至 此 Android Studio 就 算 安 装配 置 完成 。 


‘Welcome to Android Studio 





Android Studio 


冰 Start a new Android Studio project 

D Open an existing Android Studio project 

§ Check out project from Version Control ~ 
te¥ Import project (Eclipse ADT, Gradle, etc) 


tf Import an Android code sample 








亲 Configure- GetHelp™ 





图 1-15 ”Android Studio 首页 


首页 中 的 选项 也 有 不 少 ， 但 是 常用 的 有 以 下 三 个 。 
® Start anew Android Studio project: 新 建 一 个 项 目 。 


® Openan existing Android Studio project: 打开 一 个 存在 的 项 目 。 
® Importproject (Eclipse ADT,Gradle,etc ): 导入 项 目 ， 包 含 EclipseADT 项 目 、Gradle 项 目 等 。 
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1.3 Android Studio 使 用 


前 面 我 们 介绍 了 Android Studio 的 下 载 以 及 安装 ， 相 信 你 早已 按 拱 不 住 ,是 时 候 开始 实战 一 下 
了 。 本 节 内 容 包括 创建 项 目 、 运 行 以 及 调试 等 一 系列 操作 ， 带 你 熟悉 Android Studio 的 基本 使 用 。 


1.3.1 项 目 结构 


Android Studio 的 项 目 包含 App 需要 的 所 有 内 容 ， 从 源 代码 和 资源 ， 到 测试 代码 和 构建 配置 ， 
应 有 尽 有 。 当 创建 新 项 目的 时 候 ，Android Studio 会 帮助 所 有 的 文件 创建 项 目 结构 ， 在 IDE 左 侧 的 
Project 窗口 中 可 见 。 

1. 模块 

模块 是 源 文件 和 构建 设置 的 集合 ， 允 许 你 将 项 目 分 成 不 同 的 功能 单元 。 一 个 项 目 可 以 有 一 个 
或 者 多 个 模块 ， 并 且 一 个 模块 可 以 对 其 他 模块 进行 依赖 。 每 个 模块 可 以 独立 构建 、 测 试 和 调试 。 

如 果 在 自己 的 项 目 中 创建 代码 库 或 者 希望 为 不 同 的 设备 类 型 〈 例 如 电话 和 穿戴 式 设备 ) 创建 
不 同 的 代码 和 资源 组 , 但 是 保留 相同 项 目 内 的 所 有 文件 并 共享 某 些 代码 , 那么 增加 模块 数量 将 非常 
有 用 。 

可 以 点 击 File 一 New 一 New Module， 帮 助 项 目 添加 新 模块 。 

Android 有 两 种 常用 的 模块 。 


(1) Android 应 用 模块 

为 应 用 的 源 代 码 、 资 源 文件 和 应 用 级 设置 〈 例 如 模块 级 构建 文件 和 Android 清单 文件 ) 提供 容 
器 。 在 创建 新 项 目 时 ， 默 认 的 模块 名 称 是 “app”。 

在 Create New Module 窗口 中 ，Android Studio 提供 了 以 下 应 用 模块 : 





Phone & Tablet Module 手机 开发 
Android Wear Module 手表 开发 
Android TV Module 电视 开发 
Glass Module 眼镜 开发 


每 种 模块 都 提供 了 基础 文件 和 一 些 代码 模板 ， 不 同 的 设备 类 型 对 应 不 同 的 模板 。 
(2 ) 库 模块 
库 模块 是 某 个 功能 的 可 重用 代码 ， 可 用 作 其 他 项 目的 依赖 或 者 导入 其 他 项 目 中 。 库 模块 在 结构 上 
与 应 用 模块 相同 ， 但 是 在 构建 时 ， 它 将 创建 一 个 代码 归档 文件 而 不 是 APK， 因 此 无 法 安装 到 设备 上 。 
在 Create New Module 窗口 中 ，Android Studio 提供 了 以 下 库 模 块 : 
@ Android 库 : 这 种 类 型 的 库 可 以 包含 Android 项 目 中 支持 的 所 有 文件 类 型 ， 包 括 源 代码 、 资 源 
和 清单 文件 。 构 建 结果 是 一 个 Android 归档 (AAR ) 文件 ， 可 以 将 其 作为 Android 应 用 模块 
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的 依赖 项 添加 。 
@ Java 库 : 此 类 型 的 库 只 能 包含 Java 源 文件 。 构 建 结果 是 一 个 Java 归档 (JAR ) 文件 ， 可 以 将 
其 作为 Andriod 应 用 模块 或 其 他 Java 项 目的 依赖 项 添加 。 


一 些 人 也 将 模块 称 为 子 项 目 ， 完 全 没有 问题 ， 因 为 Gradle 也 将 模块 称 为 项 目 。 

例如 , 在 创建 库 模 块 并 且 希 望 以 依赖 项 的 形式 将 其 添加 到 你 的 Android 应 用 模块 时 ， 必 须 按照 
如 下 形式 进行 声明 : 

dependencies { 


compile project(':my-library-module') 


} 
2. 项 目 文件 
默认 情况 下 ，Android Studio 会 在 Android 视图 中 显示 用 户 的 项 目 文件 。 此 视图 无 法 反映 磁盘 

上 的 实际 文件 层次 结构 ,而 是 按照 模块 和 文件 类 型 组 织 , 简化 项 目 主要 源 文件 之 间 的 导航 ， 同 时 将 

不 常用 的 特定 文件 或 目录 隐藏 。 


斋 Androld 


与 磁盘 上 的 结构 相 比 ， 一 些 结构 变化 包括 : Eap 


TY Omanifests 


。 在 顶级 Gradle Script 组 中 显示 项 目 中 与 构建 相关 的 所 | lesen 
有 配置 文件 。 » com.ansen.myapplication 


» com.ansen.myapplication (androidTest) 


@ 在 模块 级 组 ( 如 果 不 同 的 产品 类 型 和 构建 类 型 使 用 不 E Mommie 





同 的 清单 文件 ) 中 显示 每 个 模块 的 所 有 清单 文件 。 ,mi 
® 在 一 个 组 中 显示 所 有 备用 资源 文件 ， 而 不 是 按照 资源 ee 
限定 符 在 不 同 的 文件 天 中 显示 。 例 如 ， 所 有 密度 版 本 ne 
的 启动 器 图 和 标 将 让 和 时 未 lA 
日 项 目 文件 结构 如 图 1-16 所 示 。 在 每 个 Android 应 用 模 Wi 
块 内 ,文件 显示 在 以 下 组 中 : ee 
> manifests 包含 AndroidManifest.xml 文件 。 人 a leet Wepre 
> java 包含 Java 源 代码 文件 (包括 JUnit 测试 代 dpe eres (Gradle Version) 
proguard-rules.pro (ProGuard Rules for app) 
码 )， 这 些 java 文 件 根 据 包 名 进行 区 分 。 Gh gradle.properties (Project Propertles) 
个 settings.gradle (Project Settings) 
> res 包含 所 有 非 代码 资源 ， 例 如 XML 布局 、 字 符 串 [local.properties (SDK Location) 
和 图 片 等 ， 这 些 资源 对 应 不 同 的 文件 夹 。 图 1-16 项 目 文件 


3. Android 项 目 视图 
要 查看 项 目的 实际 文件 结构 (包括 Android 视图 下 隐藏 的 所 有 文件 ) ， 请 从 Project 窗口 顶部 
的 下 拉 菜 单 中 选择 Project。 

选择 Project 视图 后 ， 可 以 看 到 更 多 文件 和 目录 ， 如 图 1-17 显示 。 最 重要 的 一 些 文件 和 目录 如 下 : 
。 模块 名 称 / 

> build/ 包含 构建 输出 。 

> libs/ 包含 私有 库 。 

> sre/ 包含 模块 的 所 有 代码 和 资源 文件 ， 分 为 以 下 子 目 录 : 

令 androidTest/ 包含 在 Android 设备 上 运行 的 仪器 测试 的 代码 。 
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令 main/ 包含 “ 主 ” 源 集 文 件 : 所 有 构建 变 体 共 享 的 Android 代码 和 资源 (其 他 构建 
变 体 的 文件 位 于 同 级 目录 中 ， 例 如 调试 构建 类 型 的 文件 位 于 src/debug/ 中 ) 。 
图 AndroidManifestxml 说 明 应 用 及 其 每 个 组 件 的 性 质 。 
图 java/ 包含 Java 代码 源 。 





m jn/ 包含 使 用 Java 原生 接口 (JNI) 的 原 rr rr 
生 代码 。 » .gradle 
图 gen/ 包含 Android Studio 生成 的 Java 文 gr 
件 ， 例 如 Rjava 文 件 以 及 从 AIDL 文 件 创 ”ts 
建 的 接 只 。 忆 
图 res/ 包含 应 用 资源 ， 例 如 可 绘制 对 象 文 rs 
件 、 布 局 文件 和 UI 字符 囊 。 een an 
图 assets/ 包含 原封 不 动 地 编译 到 .apk 文件 ee 
中 的 文件 。 可 以 使 用 URI 像 访问 文件 系 layout 
统一 样 访问 此 目录 ， 以 及 使 用 a 
AssetManager 以 字 节 流 形式 读 取 文件 . 例 RE 全 
如 ， 这 个 文件 夹 可 以 放 一 种 提示 音 mp3 np Oa 
头 特 ; colors.xml 
多 test/ 包含 在 JVM 上 运行 的 林地 测试 的 代码 se 
> build.gradle (模块 ) 构建 当前 模块 的 配置 。 。 ese ee 
。 build.gradle (项 目 ) 定义 适用 于 所 有 模块 的 构建 配 Bappsiml 
置 。 此 文件 已 集成 到 项 目 中 ， 因 此 应 当 在 所 有 其 他 ey 
源 代码 的 修订 控制 中 保留 这 个 文件 。 > 
4. 项 目 结构 设置 a 
要 更 改 Android Studio 项 目的 各 种 设置 ， 点 击 File 一 图 1-17 项 目 视图 


Project Structure， 打 开 Project Structure 对 话 框 。 此 对 话 框 

包含 以 下 部 分 : 

SDK Location: 设置 你 的 项 目 使 用 的 JDK、Android SDK 和 Android NDK 的 位 置 。 
Project: 设置 Gradle 和 Android Plugin for Gradle 的 版 本 ， 以 及 存储 区 位 置 名 称 。 
Developer Services: 包含 Google 或 其 他 第 三 方 的 Android Studio 附加 组 件 的 设置 。 
Modules: 允许 编辑 模块 特定 的 构建 配置 ， 包 括 目 标 和 最 低 SDK、 应 用 签名 和 库 依赖 项 。 


借助 Modules 设置 部 分 ， 可 以 为 项 目的 每 个 模块 更 改 配置 选项 。 每 个 模块 的 配置 页 面 分 成 以 
下 标签: 
Properties: 指定 编译 模块 所 用 的 SDK 和 构建 工具 的 版 本 。 
Signing: 指定 签名 证 书 。 
Flavors: 指定 SDK 的 最 低 版 本 、 最 高 版 本 、 版 本 号 、 版 本 名 称 。 我 们 也 可 以 修改 Module 的 
build.gradle 文件 修改 这 些 配 置 。 
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@ ”Build Types: 指定 编译 模式 ， 每 个 模块 都 可 以 设置 release 和 debug 模式 ， 也 可 以 根据 需要 自 
@ Dependencies: 列 出 此 模块 的 库 、 文 件 和 模块 依赖 项 。 可 以 在 这 里 添加 删除 修改 依赖 库 。 


1.3.2 创建 项 目 


利用 Android Studio, 可 以 轻松 地 为 各 种 机 型 (例如 ,手机 、 平 板 电脑 TV、Wear 和 Google Glass) 
创建 Android 应 用 。 


新 项 目 向 导 让 用 户 可 以 为 自己 的 应 用 选择 机 型 ， 并 使 用 启动 所 需 的 一 切 信息 填充 项 目 结构 。 
按 以 下 步骤 操作 来 创建 新 项 目 。 
步 又 014 启动 并 配置 项 目 。 
@ ”如果 没有 打开 项 目 ， 在 Android Studio 首页 中 点 击 Starta New Android Studio project 按钮 。 
e ”如 果 已 经 打开 一 个 项 目 , Android Studio 将 显示 开发 环境 。 要 创建 新 项 目 时 , 请 点 击 File 一 New 
一 New Project。 


这 两 种 方法 都 能 创建 项 目 ， 点 击 之 后 可 以 在 下 一 个 对 话 框 中 配置 应 用 的 名 称 、 公 司 主体 、 软 件 
包 名 称 和 项 目的 位 置 ， 如 图 1-18 所 示 。 为 你 的 项 目 输入 相应 的 值 后 点 击 Next 按钮 。 


New Project 


Configure your new project 


Application name: | My Application 

Company domain: | ansen 

Package name: [com ansen.myapplication| Done 
Include C++ support 


Project location: /Users/ansen/Documents/AndroidStudioProjects /MyApplication 


图 1-18 新 建 项 目 配置 
步骤 02h 选择 机 型 和 API 级 别 ， 如 图 1-19 所 示 。 
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0 9 Create New Project 


A Target Android Devices 


Select the form factors your app will run on 


Different platforms may require separate SDKs 


Phone and Tablet 
Minimum SDK APl 15: Android 4.0.3 QceCreamSandwich) 目 
Lower API levels target more devices, but have fewer features available 


By targeting AP 15 and ater your app will run on approximately 100.0% of the devices 
that are active on the Google Play Store. 


Help me choose 
Wear 
Minimum SDK ”Apl 21: Android 5.0 (Lollipop) 
TY 
Minimum SDK APL21: Android 5.0 (Lollipop) 
Androld Auto 


图 1-19 指定 目标 设备 
在 这 个 对 话 框 中 选择 应 用 支持 的 机 型 ， 例 如 手机 、 平 板 电脑 、TV、Wear 和 Google Glass。 


选 定 的 机 型 将 成 为 项 目 中 的 应 用 模块 。 对 于 每 种 机 型 ， 还 可 以 为 该 应 用 选择 API 级 别 。 要 获取 
详细 信息 ， 可 以 点 击 Help me choose， 如 图 1-20 所 示 。 


9 orsdpusiomhp version Datriuson 
ANDROID PLATFORM APILEVEL CUMULATIVE Ice Cream Sandwich 
VERSION DISTRIBUTION 
了 Contacts Provider ccesslbllity 
by 1 Wy Socinl Aps xplore-by-touch 
99.2% User profile Accesslbility for views 
Mere se 
ee ge one 
Calendar Provider ee 
Jay Bean ee User interface 
-re Spa checker serveees 
aar Voicemail provider Et 
Add voicemails to the device Taxtwee wew 
ee 
FT umedl ov pop mon 
Media effects for Images and videos 。 Controls for system Ul visibility 
一 ET 
Ee Iond meda pyer ND ee or ah whe 
Camem ‘Enterprise 
Face teion i 
oom md mowing ees pi 
CT 
ee ER sn 
Connectivity pn 
Androld peam for NO push wn Mprored ies 
pa ee 





74 25 Se 





1-20 Android Platform Distribution 
E 常 情况 下 采用 默认 的 就 行 ， 直 接点 击 Next 按钮 。 


步 票 034 添加 Activity, 如 图 1-21 所 示 。 可 以 选择 不 同 的 Activity 类 型 , 就 是 初始 化 的 Activity 
有 什么 功能 。 





[| 
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CeO Create New Project 


A Add an Activity to Mobile 
[ee CE | 
Aad No Activity 
mi ms 


eee oro Watermon say 


图 RE Can 
9 


Cpe CT 
1-21 选择 Activity 界面 风格 
这 里 有 很 多 选项 : 
e Add No Activity: 就 是 没有 Activity， 这 种 情况 直接 点 击 右 下 角 的 Finish 按钮 ， 项 目 就 创建 完 
或 也 
Basic Activity: 基本 的 Activity， 具 有 一 些 基本 功能 。 
Bottom Navigation Activity: 带 有 导航 栏 的 Activity。 
Empty Activity: 就 是 一 个 空 的 Activity。 官 方 推荐 这 种 方式 。 
还 有 很 多 初始 化 的 Activity ， 就 不 逐一 解释 了 。 其 实 大 部 分 情况 就 用 官方 默认 的 选项 。 直 接点 
击 Next 按钮 即 可 。 
步骤 044 此 界面 是 入 口 设置 界面 ， 如 图 1-22 所 示 。 


0 9 Create New Project 


信 Customize the Activity 


Creates a new empty activity 


Activity Name | MainActivity| 
Goreme Lot Fle 
rr 
Backwards Compatibility /AppCompan 
Erp hy 


The name of the activity class to create 


Carca Previous hen Fnish 


图 1-22 设置 入 口 界面 的 名 称 
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在 该 对 话 框 中 配置 你 的 Activity 信息 ， 可 以 输入 活动 名 称 、 布 局 名 称 。 一 般 情况 就 用 默认 的 ， 
点 击 Finish 按钮 开始 创建 项 目 ， 如 图 1-23 所 示 。 


®e Welcome to Android Studio 








Android Studio 


ilding "MyApplication' Gradle project info 


下 Check out project from Version Control ~ 
C¥ Import project (Eclipse ADT, Gradle, etc.) 


Ef Import an Android code sample 


产 Configure Get Help - 





图 1-23 创建 中 


第 一 次 创建 项 目的 时 候 会 比较 慢 ,这 是 正常 现象 。 因 为 第 一 次 需要 下 载 项 目 对 应 的 Gradle 版 本 。 
下 载 Gradle 需要 访问 外 网 ， 下 载 速度 很 一 般 ， 这 时 可 以 先 去 做 别 的 事情 ， 让 它 慢 慢 下 载 。 第 二 次 创 
建 项 目 时 就 会 很 快 。 
步骤 054 开发 应 用 。Android Studio 会 为 用 户 的 项 目 创建 默认 结构 并 打开 开发 环境 。 如 果 你 的 
应 用 支持 多 种 机 型 ，Android Studio 将 为 每 一 个 机 型 创建 一 个 包含 完整 源 文件 的 模块 文件 夹 ， 如 图 
1-24 所 示 。 

















和 
3 
上 
昌 


Wo evens MTree Ertan O00 mmiee odncomon 
Crate esteem sssSim (mes oy ec we 


辐 1-24 ”新 建 的 应 用 的 项 目 结构 
至 此 ， 你 的 项 目 就 创建 完成 了 ， 接 下 来 可 以 开发 自己 的 应 用 了 。 
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1.3.3 Android Studio 自 带 模拟 器 运行 项 目 

所 谓 模拟 器 ， 是 指 在 电脑 上 构造 一 个 演示 窗口 ， 模 拟 手 机 屏幕 上 的 App 运行 效果 。 首 先 问 自 
己 一 个 问题 ， 为 什么 要 使 用 模拟 器 ? 主要 有 以 下 几 点 : 

日 没有 安 卓 手机 也 能 开发 ， 降 低 门 槛 。 

@ 安 卓 碎片 化 严重 ， 各 种 手机 厂商 一 大 堆 ， 并 且 很 多 手机 厂商 对 原生 系统 做 了 定制 。 

@ 各 种 屏幕 适 配 。 我 们 不 可 能 买 很 多 的 安 卓 手机 ， 用 模拟 器 就 能 解决 这 个 问题 。 

创建 模拟 器 并 且 运 行 的 方法 如 下 : 

步骤 014 点 击 Android Studio 工具 栏 上 的 “Run 'app' ”按钮 ， 如 图 1-25 所 示 。 


三 app 和 其 | 
| Run 'app' (^R) 


图 1-25 运行 App 
步骤 024 Android Studio 会 先 弹出 选择 设备 界面 ， 如 图 1-26 所 示 。 从 中 可 以 看 到 当前 没有 连 
接 设 备 ， 可 点 击 Create New Virtual Device 按钮 创建 一 个 模拟 器 。 


© © Select Deployment Target 


No USB devices or running emulators detected Troubleshoot 





‘Connected Devices 
<none> 


Create New Virtual Device 


Use same selection for future launches Cancel ZL 
图 1-26 选择 接 入 设备 


步骤 034 接 下 来 选择 模拟 的 硬件 ， 如 图 1-27 所 示 ， 可 以 选择 类 型 、 型 号 ， 选 择 默认 的 Nexus 
5x， 点 击 Next 按钮 。 
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Vaal Device coniguaton 
x Select Hardware 
Androi Stucho 
Choose a device definition 
aa Re Pa CD) Noms SX 
™ Pr S502 S60dpi 
Wear pnd So lg0x1920 xxhdpi 
Sia: ye 

Newus's 0 000 pdpl [一 到 -其 
Tabler Nexus One 37 4aovsoo hdpl 

Nemus 6P ST 14 s6odpl 

Nexus 6 S96 14402-。 560dpi 

om Oovicn 


图 1-27 选择 型 号 
步 最 044 进入 如 图 1-28 所 示 的 下 载 镜像 界面 ， 下 载 Android 7.0 版 本 的 镜像 文件 ， 点 击 前 面 





的 Download 按钮 。 下 载 完 成 之 后 点 击 Next 按钮 。 


Ca Virtual Device Configuration 


System Image 


Select a system image 
6 wages Ocher ima0es 


Neese am ntedz a 
0 Downlond 26 06 





Nougat Download 25 86 


of aaa ] a wt Android 7.0 (coogle Poot 





We recommend these Coogle Play mages because 
this oevice ts compatible with Coogle Play. 


ouestions on APlleve 


See the APLIeyel distrinutlon chart 


OO A syutem image mast be selected to continue 
Cr po EE 
图 1-28 选择 镜像 


步骤 054 设置 完 镜像 之 后 会 进入 验证 配置 界面 , 可 以 设置 模拟 器 的 名 字 , 选择 横 屏 还 是 竖 屏 ， 
如 图 1-29 所 示 ， 点 击 Finish 按钮 。 
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Ceo Virtual Device Contiguration 


Ra TEL SL) 





2 


Verify Configuration 


DD News sx 5.2 1080w1920 xxhép 








重 ouon ndroid 7.0x86 











Caroa = Prevom [rren |] 
图 1-29 设置 模拟 器 参数 
步骤 06 再 次 回 到 选择 设备 界面 ， 就 会 看 到 创建 的 
模拟 器 在 选择 列表 中 ， 选 择 这 个 模拟 器 ， 点 击 OK 按钮 。 nield Endetor Me EX A 
选 定 设备 后 ， Android Studio 自动 对 项 目 进行 编译 、 打 包 成 
apk、 对 apk 进行 临时 签名 。 然 后 打开 我 们 选择 的 模拟 器 ， 
把 apk 文 件 安装 并 且 运 行 到 模拟 器 上 ,效果 如 图 1-30 所 示 。 
此 时 看 到 屏幕 的 中 间 写 着 “Hello World”， 是 不 是 有 

-种 久违 的 熟悉 感 ? 无 论 学 什么 语言 ， 我 们 运行 的 第 一 个 
程序 总 归 是 Hello World， 和 希望 看 本 书 的 读者 能 够 坚持 下 
去 ， 后 面 的 内 容 更 有 趣 噢 ! 























1.3.4 使 用 Genymotion 模拟 器 运行 


Android 自 带 的 模拟 器 运行 起 来 相对 比较 慢 ， 安 装 一 
个 App 花费 时 间 较 长 ， 并 且 效 果 不 太 流畅 ， 目 前 
Genymotion 是 比较 好 用 的 第 三 方 模拟 器 。 

1. VirtualBox (虚拟 机 〉 下 载 安装 


VirtualBox 是 一 款 开源 虚拟 机 软件 。VirtualBox 是 由 
德国 Innotek 公司 开发 、 由 Sun Microsystems 公司 出 品 的 软 
件 ， 使 用 Qt 编写 ,在 Sun 被 Oracle 收购 后 dd Oracle VM VirtualBox 。 

Genymotion 依赖 于 VirtualBox, 两 个 必须 一 起 使 用 , 所 以 首先 下 载 VirtualBox 安装 。VirtualBox 
的 下 载 地 址 为 https://www.virtualbox.org/wiki/Downloads。 

在 下 载 页 面 根据 自己 的 操作 系统 选择 不 同 版 本 下 载 ， 下 载 完 成 之 后 直接 安装 就 行 。 很 简单 ， 
一 直 点 击 “ 下 一 步 ” 即 可 。 








图 1-30 模拟 器 运行 Hello World 
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2. Genymotion 下 载 安 装 


安装 Genymotion 之 前 一 定 记得 先 安装 VirtualBox， 和 否则 Genymotion 无 法 运行 。 官 网 地 址 为 
http://www.genymotion.net/。 

















步骤 01 下 载 Genymotion 模拟 器 需要 注册 账号 后 登录 ， 然 后 直接 打开 下 载 界 
找 不 到 ， 可 以 直接 复制 : https://vww.genymotion.com/download/。 

步骤 02@ 用 浏览 器 下 载 会 比较 慢 ， 可 以 把 下 载 地 址 粘贴 进 迅雷 中 下 载 。 

步骤 003 下 载 完成 后 先 安装 Genymotion ， 才 能 进入 首页 ， 如 图 1-31 所 示 。 








面 ， 若 下 载 界 





二 
































OO Genymotion 


六 


Settings 





Your virtual devices 


User not authenticated 


图 1-31 Genymotion 首页 





nn 





步骤 04 由 














F 没 有 镜像 文件 ， 因 此 点 击 Add 按钮 进入 添加 界面 ， 如 图 1-32 所 示 。 


[Wp selectanew virtualdevice 
aoonnun CIE) oe ETE a 


Available virtual devices 


o 






Sign in to access all available virtualdevices 





图 1-32 添加 模拟 器 
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步骤 054 需要 登录 才能 下 载 镜像 文件 ， 点 击 Sign in 按钮 ， 进 入 登录 界面 ， 如 图 1-33 所 示 。 
步骤 06 输入 之 前 在 官网 注册 的 账号 进行 登录 。 登 录 成 功 之 后 在 添加 界面 会 刷新 镜像 列表 ， 
提供 各 种 不 同 的 手机 厂商 的 镜像 文件 与 安 卓 版 本 ， 如 图 1-34 所 示 。 


[selectanewvirtualdevice 




















andvnor EE oe EE a 
Avallable virtual devices o 
Phew- Geogle pot-RO-AN -100020 
Gtom Ptre -414-Ap1 16-760r4200 
全 Credentials a 


~ stomphone- 422-APN17-7681280 


Username 
~ Gumiomphors -43.Ap118-7baut280 


Password 


图 1-33 登录 图 1-34 ”Android 虚拟 机 镜像 列表 
步 又 07 4 双击 要 下 载 的 镜像 ， 进 入 创建 设备 界面 ， 可 以 指定 设备 的 名 称 ， 如 图 1-35 所 示 。 用 


ww。 amiomPmone -aa4-AP119 -Tuxl280 








默认 的 也 行 ， 点 击 Next 按钮 。 


. @ Virwal aevice creation wizard 


@ createanewvirtualdevice 


Virtual device name 


Custom Phone -4.4.4- API19 - 768x1280 1 


Please checkthe virtual device properties before deployment 


Custom Phone-44.4-Apl 19-768x1280 
同 Descriotion Custom Phonel47- 768x1280 XHDPN AOSP4.44API 19 
Svstemversion 


Name Ganvmotion Phone-444-API19-290 
Descriotion Gervmotion Virtual Device for Phone 
Android Version, 444 
Release date 周二 3 月 210616032017 
Version number 290 

DD Sereensize- Denslty 7658x1280.320dol 

Memorvslae 2048 MB 

于 NumberofCPUs 4 

HpDatadskcaoacty 8192M8 


@ This virtual device has been updated since the last deployment. The new version will be downloaded. (210MB) 


口 pe not download the new version, use the old one from the local cache 
图 1-35 ”创建 设备 


步骤 08 4 接 下 来 就 会 显示 下 载 界面 了 ， 下 载 会 比较 慢 。 下 载 完成 之 后 点 击 Finish 按钮 ， 如 
1-36 所 示 。 








测 
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Retrieveand deploy the new virtual device 








图 1-36 下 载 镜像 中 


步骤 09 4 接 下 来 就 能 在 首页 看 到 下 载 的 设备 了 。 选 中 设备 后 点 击 Start 按钮 或 者 双击 这 个 设备 
运行 模拟 器 ， 如 图 1-37 所 示 。 

至 此 ，Genymotion 模拟 器 安装 完成 了 。 回 到 Android Studio 项 目 界面 ， 点 击 工具 栏 上 的 “Run 
'app'” 按 钮 运行 项 目 。 在 选择 设备 中 选择 刚 运行 的 Genymotion 模拟 器 ， 最 后 效果 如 图 1-38 所 示 。 
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图 1-37 已 下 载 镜 像 列表 图 1-38 ”Genymotion 模拟 器 运行 Hello World 
大 家 用 模拟 器 开发 的 时 候 建 议 用 Genymotion 模拟 器 ， 比 官方 自 带 的 好 用 很 多 。 


1.3.5 ” 真 机 运行 


除了 在 模拟 器 上 运行 外 ， 还 可 以 直接 在 手机 上 运行 。 
1. 手机 开启 开发 者 模式 
手机 默认 是 未 开启 开发 者 模式 的 ， 所 以 需要 在 手机 的 “设置 ”界面 中 手动 开启 。 
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步 又 014 点击“ 设置 ”一 “关于 手机 ”一 “版 本 号 "， 连 续 点 击 版 本 号 5 次 就 激活 开发 者 模 
式 ， 如 图 1-39 所 示 。 可 能 某 些 国产 机 界面 不 一 样 ， 但 是 只 要 找到 版 本 号 连续 $ 次 点 击 就 对 了 。 

步 又 024 进入 开发 者 选项 界面 ， 点 击 “ 设 置 ”一 “全 局 高 级 设置 ”一 “开发 者 选项 ”界面 ， 
开启 USB 调试 ， 如 图 1-40 所 示 。 
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允许 模拟 位 置 


选择 调试 应 用 未 设置 f 应 用 


等 待 调试 器 


通过 USB 验证 应 用 


显示 和 触摸 操作 


指针 位 置 


演示 模式 








1-39 开启 开发 者 模式 图 1-40 开启 USB 调试 
这 里 的 手机 是 锤子 手机 ， 不 同 的 手机 厂商 设置 界面 略 有 不 同 ， 但 是 功能 都 一 样 。 没 找到 的 读 
者 仔细 查找 或 者 求助 于 网 页 搜索 。 
2. 安装 USB 驱动 


只 有 Windows 系统 需要 下 载 这 个 手机 对 应 的 USB 驱动 , 大 家 根据 自己 的 型 号 去 对 应 的 手机 厂 
商 官 网 下 载 ， 然 后 安装 。 安 装 之 后 用 手机 数据 线 连接 电脑 。 

如 果 是 Mac 电脑 是 不 需要 下 载 驱动 的 ， 直 接 用 数据 线 连接 电脑 即 可 。 有 些 手 机 连接 之 后 可 能 会 识 
别 不 了 个 别 情 况 ) ， 可 以 参考 一 篇 教程 : http://blog.csdn.net/lowprofile_coding/article/details/48443249。 


如 何 判断 手机 是 否 连 接 成 功 





在 Android Studio 底部 有 一 个 Android Monitor, 可 以 看 到 当前 连接 的 设备 , 还 能 看 到 手机 上 
应 用 程序 打印 的 Log， 如 图 1-41 所 示 。 当 然 ， 运 行 App 的 时 候 也 能 看 到 连接 的 设备 列表 。 
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图 1-41 Android Studio 查看 连接 设备 
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3. 运行 App 
设备 连接 成 功 之 后 点 击 Android Studio 工具 栏 上 的 “Run 'app' ”按钮 。 选 择 设备 〈 这 里 是 锤 
手机) ， 然 后 就 能 在 手机 上 看 到 Hello World 了。 


be 
册 





1.4 调试 项 目 


Android Studio 自 带 的 调试 程序 让 用 户 能 够 对 运行 在 模拟 器 或 者 真 机 设备 的 应 用 进行 调试 。 


1.4.1 Debug 断 点 调试 


Debug 断 点 调试 是 每 个 开发 工具 必 备 的 功能 ， 当 然 Android Studio 也 有 , 使 用 Debug 断 点 调试 
可 以 查看 运行 中 变量 的 值 与 表达 式 的 值 ， 可 以 一 行 一 行 代码 逐步 进行 调试 。 

如 果 你 的 程序 是 逻辑 问题 (程序 本 身 不 报错 ， 但 是 结果 错误 ) ， 用 Debug 调试 进行 问题 定位 
非常 方便 。 

1. 设置 断 点 

找到 想 断 点 的 代码 行 位 置 ， 点 击 该 代码 左 侧 空白 处 ， 或 者 将 光标 停留 在 这 行 代码 上 ， 然 后 按 
组 合 键 CtrI+F8 (在 Mac 上 ， 按 Command+F8) ， 如 图 1-42 所 示 。 
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Bpublic class MainActivity extends AppCompatActivity { 


Dsre 9 enverride 
» DandroidTest "of protected void onCreate(Bundle savedInstanceState) { 


super. onCreate (savedInstanceState)’; 


“Ee SetContentyievtR .Layout activity_main) 站 


Y Djava 
Y comansen.myappllca 回 | nt 
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图 1-42 添加 断 点 

例如 ， 想 追踪 MainActivity 中 变量 a 的 值 ， 就 可 以 在 声明 a 变量 那 一 行 设置 一 个 断 点 。 可 以 看 
到 左 侧 空白 处 有 一 个 酒 红色 的 原点 。 

2. 调试 

给 需要 调试 的 代码 设置 断 点 之 后 ， 点 击 Android Studio 工具 栏 上 的 Debug App 菇 按钮 运行 项 

目 。 点 击 这 个 按钮 之 后 就 会 以 Debug 模式 运行 App。 

当 软 件 运行 到 “int a=10; ”这 一 行 代码 时 ，Android Studio 会 暂停 应 用 的 运行 ， 并且 Android 
Studio 会 显示 Debugger 标签 ， 如 图 1-43 所 示 。 
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1-43 Debug 中 


我 们 可 以 使 用 Debugger 标签 中 的 工具 来 确定 应 用 的 状态 : 


要 检查 变量 的 对 象 树 ， 在 Variables 视图 中 将 其 展开 。 

要 在 当前 执行 点 对 某 个 表达 式 求 值 ， 点 击 Evaluate Expression [时 
要 前 进 到 下 一 行 代码 (而 不 进入 方法 )， 点 击 Step Over 这 按钮 
要 前 进 到 方法 调用 内 的 第 一 行 ， 点 击 Step Into 按钮。 

要 前 进 到 当前 方法 之 外 的 下 一 行 ， 点 击 Step Out it 而 按钮. 

要 让 应 用 继续 正常 运行 点击 Resume Program 对 > 按钮. 


例如 , 想 看 到 “a+=20; pe 云 行 后 的 结果 , 可 以 点 击 Step Over 按钮 , 然后 可 以 在 Variables 
视图 中 看 到 a 的 值 等 于 30， 如 图 1-44 所 示 。 
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图 1-44 ”显示 代码 的 运行 结果 
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如 果 这 个 断 点 调试 完成 ， 让 应 用 继续 正常 运行 ， 点 击 Resume Program 按钮 。 


1.4.2 “日志 调试 


1. 写 入 日 志 


要 在 代码 中 写 入 日 志 , 使 用 Log 类, 日 志 消 息 可 以 帮助 了 解 执行 流程 。android.util.Log 常用 的 
方法 有 以 下 5 个: 
Log.v0: 对 应 verbose， 调 试 颜 色 为 黑色 的 ， 任 何 消息 都 会 输出 。 
Log.d0: 对 应 debug， 仅 输出 debug 调试 的 意思 ， 但 它 会 输出 上 层 的 信息 。 
Log.i0: 对 应 info， 一 般 提 示 性 的 消息 。 
Log.w(): 对 应 warmm， 输 出 为 蓝 色 ， 可 以 看 作 waming ( 警告 ) 一 般 需要 注意 优化 Android 代 
码 。 
@ Log.e0: 对 应 error (异常 ) 输出 为 红色 ， 红 色 错误 需要 认真 解决 。 
这 5 个 方法 都 有 两 个 参数 ， 第 一 个 参数 是 tag (为 Log 打上 标签 ) ， 第 二 个 参数 是 打印 内 容 。 
2. 查看 日 志 
首先 在 MainActivity 的 onCreate 中 加 入 打印 5 种 日 志 的 代码 。 
Log.v("ansen", "verbose") 7 
Log.d("ansen", "debug") 
Log.i("ansen","info"); 
Log.w("ansen", "warn"); 


Log.e("ansen", "error") 7 


重新 运行 程序 , 然后 在 Android Monitor 标签 的 logcat 中 看 到 输出 的 日 志 , 效果 如 图 1-45 所 示 。 


oe 2 MainActivity /eva - MyAoplicaton -[-/ icauon 









EY RTETLETEINT a 
Ca Wapphemion) Capp) Eure) EJ moe) Cfom) ED com) aneen) BD maopteanon) 站 wanevy 
Poyeet -+ SF 有 © ww » [i < 
MyApplication ~/Documents/Andro 一 § 
"te Bi ee Ly EAIUGEViGT 四 
T Paapp 说 epverrlde 
i » Dbuid Be protected woid oncreatelaundte savedlnstancestate) 
per ereate cavalnr tocar te); 
EE an， 
9 androldrest 
四 " Dmain 4 
s v Djava 汪 
i ”omanten myappic 
8 站 wainhctviy 2 
和 


LE 


Bre | 


© Ree showonly selectedappication 回 


二 
由 

4 5Dcbve SToD0 NN 本 Ta 下 ceo eventlog 加 GradleConsole 
Crate utd nahed nas ltms O mutes ag0) hs co cocomea> 时 


1-45 查看 log 


30 | Android App 开发 从 入 门 到 精通 





@ 选择 设备 。 

@ 选择 运行 的 程序 包 名 。 

@ 选择 要 显示 的 日 志 级 别 ， 对 应 Log 打印 日 志 的 5 种 方法 。 

@ 根据 字符 串 过 滤 日 志 ， 例 如 这 里 是 根据 ansen 过 滤 ， 日志 的 tag 或 内 容 必须 要 包含 ansen 
这 个 字符 串 才 会 显示 出 来 。 

@@ 在 过 滤 之 后 的 日 志 中 进行 字符 串 查找 。 

我 们 在 MainActivity 的 oncreate 方法 中 最 后 一 行 用 到 了 java sdk 里 面 的 System 类 来 打印 ， 这 
样 也 是 可 以 的 ， 但 是 不 推荐 使 用 。System 类 打印 日 志 没有 tag 标签 , 没有 日 志 级 别 ， 当 日 志 过 多 时 
过 滤 不 方便 。 





1.5 “Eclipse 项 目 迁 移 至 Android Studio 


在 企业 开发 中 ， 会 经 常 参考 别人 写 的 开源 项 目 ， 避 免 重 复 编写 代码 。 

将 项 目 迁 移 至 Android Studio 需要 适应 新 的 项 目 结构 、 构 建 系统 和 IDE 功能 。 从 Eclipse 迁移 
至 Android 项 目 ，Android Studio 会 提供 导入 工具 ， 可 以 将 现 有 代码 快速 移 至 Android Studio 项 目 ， 
这 个 项 目 基于 Gradle 的 构建 文件 。 

Android Studio 为 使 用 Eclipse 创建 的 现 有 Android 项 目 提 供 自动 导入 工具 。 


1.5.1 Eclipse 项 目 迁 移 条 件 


Eclipse 项 目 迁移 的 主要 条 件 如 下 : 

@ 确保 Eclipse 项 目 根 目录 包含 AndroidManifestxml 文件 。 此 外 ， 根 目录 必须 包含 Eclipse 
的 .project 和 .classpath 文件 或 res/ 和 src/ 目 录 。 

”在 需要 导入 的 project.properties 或 .classpath 文件 中 注释 掉 对 Eclipse 项 目 库 文 件 的 任何 引用 。 
导入 之 后 手动 在 build.gradle 文件 中 添加 这 些 引用 。 

”记录 工作 区 目录 、 路 径 变 量 和 任何 实际 路 径 映 射 可 能 会 有 所 帮助 ， 这 些 内 容 可 用 于 指定 任何 
未 解析 的 相对 路 径 、 路 径 变 量 和 链接 的 资源 引用 。Android Studio 允许 在 导入 过 程 中 手动 指定 
任何 未 解析 的 路 径 。 


1.5.2 将 Eclipse 项 目 导 入 Android Studio 


将 Eclipse 项 目 导 入 Android Studio 的 操作 步骤 如 下 : 


步 又 014 启动 Android Studio， 并 关闭 已 经 打开 的 Android Studio 项 目 。 
步骤 02 4 在 Android Studio 菜单 中 点 击 File 一 New 一 Import Project， 或 在 “Welcome” 屏 幕 中 
点 击 Import project (Eclipse ADT, Gradle, etc.)。 
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步骤 03G 选择 包含 AndroidManifestxml 文件 的 Eclipse 项 目 文件 夹 ， 并 点 击 OK 按钮 ， 如 图 
1-46 所 示 。 
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cancel MD 
图 1-46 选择 项 目 导入 
步骤 04 选择 目标 文件 夹 ， 然 后 点 击 Next 按钮 ， 如 图 1-47 所 示 。 


‘ee. Import Project from ADT (Eclipse Android) 





Importing a project creates a full copy of the project and does not alter the 
original Eclipse project. 


Import Destination Directory: 
/Users/myanchar/AndroidStudioprojects /DrawerNavigation 


全 Cancel 


rrevious 


图 147 选择 目标 文件 夹 
步 最 054 选择 导入 选项 ， 然 后 点 击 Finish 按钮 。 


步骤 064 导入 过 程 中 会 提示 将 任何 库 和 项 目 依赖 关系 迁移 到 Android Studio, 并 将 依赖 关系 声 
明 添 加 到 build.gradle 文件 ， 如 图 1-48 所 示 。 


[ Import Project from ADT (Eclipse Android) 


The ADT project importer can identify some jar files and even whole source 
copies of libraries, and replace them with Gradle dependencies. However, it 
cannot figure out which exact version of the library to use, so it will use the 
latest. If your project needs to be adjusted to compile with the latest library, 
you can either import the project again and disable the following options, or 
better yet, update your project. 

Replace jars with dependencies, when possible 


Replace library sources with dependencies, when possible 


Other Import Options: 
Create Gradle-style (camelCase) module names 


了 3) Cancel Previous “” 匡 
图 1-48 导入 设置 
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导入 过 程 中 还 将 用 Maven 依赖 关系 替换 具有 已 知 Maven 坐标 的 任何 已 知 源 代 码 库 、 二 进 制 库 
和 JAR 文件 ， 因 此 无 须 手 动 保留 这 些 依赖 关系 。 

导入 选项 还 允许 输入 工作 区 目录 和 任何 实际 路 径 映射 ， 以 处 理 任何 未 解析 的 相对 路 径 、 路 径 
变量 和 链接 的 资源 引用 。 

Android Studio 导入 应 用 并 显示 项 目 导入 过 程 文 档 。 查 看 文档 ， 了 解 项 目 重组 和 导入 过 程 的 详 
细 信 息 ， 如 图 1-49 所 示 。 
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图 1-49 导入 过 程 文档 


将 项 目 从 Eclipse 导入 Android Studio 后 ，Android Studio 中 的 每 个 应 用 模块 文件 夹 都 包含 该 模 
块 的 完整 源 代码 集 ， 包 括 src/main/ 和 src/androidTest/ 目 录 、 资 源 、 构 建文 件 以 及 AndroidManifestxml。 
在 开始 应 用 开发 前 应 该 解决 项 目 导入 文档 说 明 中 显示 的 所 有 问题 , 确保 项 目 重组 和 导入 过 程 成 功 完成 。 


1.5.3 ”验证 导入 是 否 成 功 


直接 运行 项 目 ， 点 击 Android Studio 工具 栏 上 的 “Run 'app'” 按 钮 ， 如 果 有 问题 可 以 根据 报错 
提示 进行 解决 。 如 果 能 够 直接 运行 到 设备 上 就 说 明 导 入 成 功 。 


1.6 创建 Android 库 


Android 库 在 结构 上 与 Android 应 用 模块 相同 。 它 可 以 提供 构建 应 用 所 需 的 一 切 内 容 ， 包 括 源 
代码 、 资 源 文件 和 Android 清单 。 不 过 ，Android 库 将 编译 到 可 以 用 作 Android 应 用 模块 依赖 项 的 
Android 归档 (AAR) 文件 ， 而 不 是 在 设备 上 运行 的 APK。 与 JAR 文件 不 同 ，AAR 文件 可 以 包含 
Android 资源 和 一 个 清单 文件 , 这 样 除了 Java 类 与 方法 外 , 还 可 以 捆绑 布局 和 可 绘制 对 象 等 共享 资 
源 。 
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库 模 块 在 以 下 情况 下 非常 有 用 : 

@ 构建 使 用 某 些 相同 组 件 (例如 Activity、 服 务 或 UI 布局 ) 的 多 个 应 用 。 

”构建 存在 多 个 APK 变 体 ( 例如 免费 版 本 和 付费 版 本 ) 的 应 用 并 且 需 要 在 两 种 版 本 中 使 用 相同 

的 核心 组 件 。 

就 像 公 司 有 10 多 个 App， 可 以 把 所 有 App 都 需要 用 的 东西 封装 到 库 模块 中 ， 例 如 网 络 请 求 、 
在 线 加 载 图 片 等 。 

这 10 多 个 项 目 都 依赖 这 个 库 ， 而 不 是 10 多 个 项 目 都 写 一 遍 网 络 请 求 的 代码 ， 并 且 用 库 的 方 
式 方便 修改 。 

当 访问 网 络 的 代码 有 bug 的 时 候 ， 只 需要 修改 这 个 库 文件 的 代码 就 好 了 。 


1.6.1 创建 库 模 块 
要 在 项 目 中 创建 一 个 新 的 库 模 块 ， 需 要 进行 以 下 操作 : 


步骤 01 点 击 File>New 一 New Moduleo 
步骤 02 在 出 现 的 Create New Module 对 话 框 中 ， 依 次 点 击 Android Library 和 Nexto 


还 存在 一 个 用 于 创建 Java 库 的 选项 ,可 以 构建 传统 的 JAR 文件 。 尽管 JAR 文件 在 大 多 数 项 


目 中 都 非常 实用 (尤其 在 希望 与 其 他 平台 共享 代码 时 )， 但 这 种 文件 不 允许 包含 Android 资 
源 或 清单 文件 ， 而 后 者 对 于 Android 项 目 中 的 代码 重用 非常 有 用 。 根 据 需求 决定 。 





步骤 03 为 你 的 库 命 名 ,并 为 库 中 代码 选择 一 个 最 低 的 SDK 版 本 ,然后 点 击 Finisho 在 Gradle 
项 目 同步 完成 后 ， 库 模块 将 显示 在 左 侧 的 Project 面板 中 。 


1.6.2 ”将 库 模块 导入 到 项 目 中 


有 时 我 们 的 项 目 要 用 别人 项 目 中 依赖 的 库 ， 手 动 复制 过 来 太 麻烦 ，Android Studio 支持 导入 库 
交心 


步骤 01 人 点 击 File 一 New 一 Import Module。 
步骤 02Q 选择 库 模块 目录 的 位 置 ， 然 后 点 击 Finish。 


库 模 块 的 代码 将 会 复制 到 你 的 项 目 中 ， 也 可 以 修改 库 代码 。 
1.6.3 ”将 应 用 模块 转换 为 库 模块 


如 果 希 望 把 应 用 模块 转换 为 库 模块 ， 可 以 采用 以 下 步骤 : 
步 紧 014 打开 现 有 应 用 模块 的 build.gradle 文件 。 在 项 部 看 到 以 下 内 容 : 
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apply Plugin: "com.android.appPlication'" 


步骤 024 修改 成 下 面 这 行 代码 : 


apply Plugin: "com.android.l1ibrary'" 





步 又 03 点 击 Sync Project with Gradle Files。 


将 应 用 模块 转换 为 库 模块 就 是 这 么 简单 ， 只 需要 修改 一 行 代码 。 模 块 的 结构 是 一 样 的 ， 改 了 
之 后 构建 的 是 AAR 文件 ， 而 不 是 可 以 运行 在 手机 上 的 APK 文件 。 


1.6.4 ”开发 库 模 块 的 注意 事项 


在 开发 库 模 块 和 相关 应 用 时 ， 需 要 注意 以 下 行为 和 限制 。 
将 库 模 块 引用 添加 至 你 的 Android 应 用 模块 后 ,可 以 设置 它们 的 相对 优先 级 。 构 建 时 ， 库 会 按 
照 一 次 一 个 的 方式 与 应 用 合并 ， 并 按照 从 低 到 高 的 优先 级 顺序 进行 。 


资源 合并 冲突 : 构建 工具 会 将 库 模 块 中 的 资源 与 相关 应 用 模块 的 资源 合并 。 如 果 在 两 个 模块 
中 均 定义 了 给 定 资源 ID， 将 使 用 应 用 中 的 资源 。 

如 果 多 个 AAR 库 之 间 发 生 冲 突 ， 将 使 用 依赖 项 列表 首先 列 出 (位 于 dependencies 块 项 部 ) 
库 中 的 资源 。 

为 了 避免 常用 资源 ID 的 资源 冲突 ， 请 使 用 在 模块 (或 在 所 有 项 目 模块 ) 中 具有 唯一 性 的 前 
级 或 其 他 一 致 的 命名 方案 。 

库 模 块 可 以 包含 JAR 库 : 可 以 开发 一 个 自身 包含 JAR 库 的 库 模块 。 不 过 ， 需 要 手动 编辑 相 
关 应 用 模块 的 构建 路 径 ， 并 添加 JAR 文件 的 路 径 。 

库 模 块 可 以 依赖 外 部 JAR 库 : 可 以 开发 一 个 依赖 于 外 部 库 (例如 Maps 外 部 库 ) 的 库 模块 。 
在 这 种 情况 下 ， 相 关 应 用 必须 针对 包含 外 部 库 (例如 Google API 插件 ) 的 目标 构建 。 需 要 注 
意 的 是 ， 库 模块 和 相关 应 用 都 必须 在 其 清单 文件 的 元 素 中 声明 外 部 库 。 

库 模 块 不 得 包含 原始 资源 : 工具 不 支持 在 库 模 块 中 使 用 原始 资源 文件 (保存 在 assets/ 目 录 中 )。 
应 用 使 用 的 任何 原始 资源 都 必须 存储 在 应 用 模块 自身 的 assets/ 目 录 中 。 

应 用 模块 的 minSdkVersion 必须 大 于 或 等 于 库 定 义 的 版 本 : 库 作 为 相关 应 用 模块 的 一 部 分 编 
译 ， 因 此 ， 库 模块 中 使 用 的 API 必须 与 应 用 模块 支持 的 平台 版 本 兼容 。 

每 个 库 模块 都 会 创建 自己 的 R 类 : 在 构建 相关 应 用 模块 时 ， 库 模块 将 先 编译 到 AAR 文件 中 ， 
然后 添加 到 应 用 模块 中 。 因 此 ， 每 个 库 都 有 其 自己 的 R 类 ， 并 根据 库 的 软件 包 名 称 命名 。 

从 主 模块 和 库 模块 生成 的 R 类 会 在 所 需 的 所 有 软件 包 (包括 主 模块 的 软件 包 和 库 的 软件 包 ) 
中 创建 。 


1.6.5 ”AAR 文件 详解 


AAR 文件 的 文件 扩展 名 为 .aar，Maven 工件 类 型 也 应 当 是 .aar。 文 件 本 身 是 一 个 包含 以 下 强制 
性 条 目的 zip 文件 : 
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/AndroidManifestxml 
/classes.jar 

/res/ 

/R.txt 


此 外 ，AAR 文件 可 能 包含 以 下 可 选 条 目 中 的 一 个 或 多 个 : 

/assets/ 

/libs/ 名 称 jar 

/jni/abi 名 称 /名 称 .so( 其 中 abi 名 称 是 Android 支持 的 ABI 之 一 ) 
/proguard.txt - /lint.jar 


1.7 项 目 依赖 库 


依赖 库 的 方法 主要 有 两 种 : 一 种 是 本 地 依赖 ， 另 一 种 是 在 线 依赖 。 

本 地 依赖 库 一般 是 公司 内 部 把 一 些 项 目 通用 的 代码 封装 成 库 ， 可 以 根据 业务 需求 随时 修改 代 
码 ， 并 且 代码 都 在 本 地 ， 不 会 被 公开 。 

在 线 依赖 库 一 般 是 个 人 或 者 组 织 对 解决 某 个 问题 的 代码 进行 开源 ， 例 如 从 服务 器 请 求 数据 ， 
这 是 市 面 上 90% 的 App 都 需要 用 到 的 功能 ，Android 自 带 的 访问 网 络 api 太 烦 琐 ， 于 是 就 需要 把 网 
络 请 求 的 代码 进行 封装 ， 这 样 就 有 一 些 公 司 会 把 自己 App 中 访问 网 络 的 代码 封装 成 一 个 库 ， 提 交 
到 远程 中 央 仓库 。 别 人 就 能 通过 在 线 依赖 的 方式 引用 这 个 库 , 大 家 都 站 在 巨人 的 肩膀 上 , 还 有 一 个 
好 处 就 是 ， 这 个 库 有 bug， 只 要 开源 者 修复 这 个 问题 ， 然 后 提交 一 个 新 的 版 本 ， 所 有 依赖 者 根本 不 
需要 修改 代码 ， 只 需要 修改 版 本 号 即 可 解决 bug。 


1.7.1 依赖 本 地 库 


依赖 本 地 库 (module〉 就 是 源 代码 在 你 当前 电脑 上 ， 依 赖 库 有 什么 问题 ， 可 以 随时 修改 。 
例如 ， 在 自己 已 打开 的 项 目下 新 建 一 个 库 “my-library-module”， 如 果 想 依赖 这 个 库 ， 打 开 应 
用 模块 的 build.gradle 文件 ， 并 向 dependencies 块 中 添加 一 行 如 下 的 新 代码 : 


compile project(':my-library-module') 


点 击 Sync Project with Gradle Files。 修 改 后 的 项 目 结构 如 图 1-50 所 示 。 








36 | Android App 开发 从 入 门 到 精通 








ES 
ET 


EL? 























图 1-50 新建 module 并 进行 依赖 


1.7.2 在线 依 赖 库 


在 线 依赖 源 代码 保存 在 服务 器 中 ， 当 我 们 第 一 次 依赖 时 ， 会 从 远程 仓库 中 下 载 jar 或 者 aar 文 
件 ，Android Studio 之 前 默认 的 在 线 依赖 仓库 是 jcenter， 从 Android Studio 3.0 之 后 增加 了 Google 
自己 的 仓库 。 上 传 到 远程 仓库 上 的 在 线 依赖 库 (module) ， 必 须要 对 代码 进行 开源 。 

在 线 依赖 的 库 可 以 看 到 源码 ， 但 是 不 能 修改 。 在 后 面 的 章节 中 我 会 告诉 大 家 如 何 让 自己 的 
module 上 传 到 jcenter 服务 器 。 

在 线 依赖 很 简单 ， 跟 本 地 依赖 一 样 ， 也 只 需要 一 行 代码 。 打 开 应 用 模块 的 build.gradle 文件 ， 
并 向 dependencies 块 中 添加 一 行 新 代码 。 例 如 ， 新 建 项 目 时 就 有 的 v7 包 依赖 。 


compile 'com.android.support:appcompat-v7:26.+' 


在 线 依赖 库 的 代码 能 不 能 不 开源 


1.8 应 用 清单 文件 





每 个 应 用 的 根 目录 中 都 必须 包含 一 个 清单 文件 (AndroidManifest.xml) 。 该 文件 向 Android 系 
统 提 供应 用 的 必要 信息 ， 系 统 必须 具有 这 些 信息 才能 运行 应 用 的 任何 代码 。 
此 外 ， 清 单 文件 还 包含 以 下 功能 : 
为 应 用 设置 包 名 。 软 件 包 名 称 是 当前 应 用 的 唯一 标识 符 。 
描述 应 用 的 各 个 组 件 ， 和 包括 Activity、 服 务 、 广 播 接收 器 和 内 容 提供 者 。 它 还 为 实现 每 个 组 件 
的 类 命名 并 发 布 其 功能 ， 例 如 它们 可 以 处 理 的 Intent 消息 。 这 些 声明 向 Android 系统 告知 有 
关 组 件 以 及 可 以 启动 这 些 组 件 的 条 件 的 信息 。 
确定 应 用 组 件 的 进程 。 
声明 应 用 有 哪些 权限 ， 还 声明 其 他 应 用 与 该 应 用 组 件 交 互 所 需 具备 的 权限 。 
声明 应 用 需要 的 最 低 Android API 级 别 。 
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1.8.1 清单 文件 结构 


下 面 的 代码 段 显 示 了 清单 文件 的 通用 结构 以 及 可 以 包含 的 每 个 元 素 。 
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</application> 
</manifest> 


1.8.2 ”文件 约定 


适用 于 清单 文件 中 所 有 元 素 和 属性 的 约定 和 规则 。 

1. 元 素 

只 有 <manifest> 和 <application> 元 素 是 必需 的 ， 这 两 个 元 素 都 只 能 有 一 个 并 且 必 须 唯 一 。 其 他 
大 部 分 元 素 可 以 出 现 多 次 或 者 根本 不 出 现 , 但 清单 文件 中 必须 存在 其 中 某 些 元 素 才 有 效 。 元 素 的 值 
通过 属性 进行 设置 。 

同一 级 别 的 元 素 不 区 分 先后 顺序 。 例 如 ，<activity>、<provider> 和 <service> 元 素 可 以 按 任 
何 顺序 混合 在 一 起 。 

2. 属性 

所 有 的 属性 都 是 可 选 的 ， 但 是 有 些 元 素 必须 要 指定 属性 才能 有 效 。 

除了 根 <manifest> 元 素 的 一 些 属性 外 ， 所 有 属性 名 称 均 以 android: 前 级 开头 。 例 如 ， 
android:alwaysRetainTaskState 。 

3. 声明 类 名 

有 很 多 元 素 可 以 指定 java 类 ， 例 如 <application> 、Activity(<activity>)、 服 务 (<service>)、 广 
播 接 收 器 (<receiver>) 以 及 内 容 提 供 者 (<provider>)。 

<manifest package="com.ansen.myapplication" ... > 

<application 
ee 
<activity android:name=".MainActivity"> 
ee 
</application> 
</manifest> 


如 果 我 们 没有 给 manifest 指定 package 属性 ， 写 法 如 下 : 
<manifest ... > 
<application 
ee 
<activity android:name="com.ansen.myapplication.MainActivity"> 
</activity> 
</application> 
</manifest> 


4. 多 个 值 
如 果 指定 多 个 值 ， 就 一 直 重 复 增加 这 个 元 素 ， 而 不 是 给 一 个 元 素 赋 多 个 值 。 例 如 ，intent 过 滤 
器 可 以 有 多 个 : 


<intent=filter ac 之 
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<action android:name="android.intent.action.EDIT" /> 
<action android:name="android.intent.action.INSERT" /> 
<action android:name="android.intent.action.DELETE" /> 
人 
5. 权限 
权限 是 一 种 限制 ， 用 于 限制 对 部 分 代码 或 设备 数据 的 访问 。 增 加 限制 是 为 了 保护 可 能 被 误 用 
以 致 破坏 或 损害 用 户 体验 的 关键 代码 。 
如 果 应 用 需要 访问 受权 限 保护 的 功能 ， 就 必须 在 清单 中 使 用 <uses-permission> 元 素 声 明 应 用 需 
要 该 权限 。 
将 应 用 安装 到 设备 上 之 后 ， 安 装 程序 会 通过 检查 签署 应 用 证 书 的 颁发 机 构 并 在 某 些 情况 下 ) 
询问 用 户 ， 确 定 是 否 授予 请 求 的 权限 。 如 果 授予 权限 ， 则 应 用 能 够 使 用 受权 限 保护 的 功能 。 否 则 ， 
访问 这 些 权限 保护 的 功能 会 失败 ， 并 且 不 会 向 用 户 发 送 任何 通知 。 


1.9 ”常用 快捷 键 





Android Studio 为 了 方便 操作 ， 提 供 了 很 多 快捷 键 。 我 们 也 可 以 为 某 个 功能 自 定义 快捷 键 。 表 
1-3 列 出 了 常用 的 快捷 键 。 


表 1-3 常用 的 快捷 键 





Windows/Linux Mac 


二 Command+S 
打开 项 目 结构 对 话 杠 Command + ; (英文 分 号 ) 


查找 Command + PF 


搜索 全 部 内 容 (包括 代码 和 菜单 ) 按 两 次 Shift 


[cmrR | command+R 


生成 代码 (getter、setter、 构 造 函 数 、hashCode/equals、 | Alt+ Insert Command +N 
toString、 新 文件 、 新 类 ) 


复制 当前 行 或 选择 Command + D 
Cul+ 空格 键 Control + 空格 键 











重 命 名 Shift + F6 Shift + F6 
缩 进 /取消 缩 进行 Tab/Shift + Tab Tab/Shift + Tab 
删除 插入 符 处 的 行 Ctrl+Y Command + 退 格 键 








1.9.1 自 定义 快捷 键 


首先 打开 快捷 键 设置 界面 , 只 需 在 Android Studio 中 点 击 File 一 Settings 一 Keymap (在 Mac 上 ， 
点 击 File 一 Properties 一 Keymap) ， 如 图 1-51 所 示 。 
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a 


» Appearance & Behavior 


Keymap 


» Editor 


Plugins 


» Version Control 

» Build, Execution, Deployment 
» Languages & Frameworks 

» Tools 


@ 快捷 键 类 型 ， 从 此 列表 中 选择 某 个 操作 系统 或 者 某 个 IDE 工具 对 应 的 快捷 键 。 


Keymap 


Keymaps: Macosx105+ 回 


Preferences 


Copy | Reset | | Delete 
a 





4 中 
Ca Editor Actions 
Add or Remove Caret XOButtonl Click 
Add Rectangular Selectioh on Mouse Drag TomBurtonl Click 
Backspace @ 
Move carer Backward a Pdragraph 
Choose Lookup ltem 到 
[ er sent 8 
Choo! Add Keyboard Shortcut rr 


Choo! Add Mouse Shortcut 外 
Clone 。 Add Abbreviation 


Ck 
Or Remove 全 车 


Move | 
Move Caret to Code Block End with Selection 下 人 中] 
Move Caret to Code Block Start TSEL 
Move Caret to Code Block Start with Selection YM 
ca /ppy ”三 

图 1-51 设置 快捷 键 


@ 快捷 菜单 ， 右 击 可 以 对 其 进行 修改 。 可 以 为 这 个 操作 添加 更 多 键盘 快捷 键 ， 添 加 鼠标 快捷 
键 以 将 某 个 操作 与 鼠标 点 击 关 联 ， 或 者 移 除 当前 快捷 键 。 
@ Copy 按钮 : 从 快捷 键 类 型 下 拉 菜 单 中 选择 一 个 要 复制 的 类 型 ， 然 后 点 击 Copy 按钮 以 创建 
新 的 快捷 键 类 型 。 可 以 修改 类 型 名 称 和 快捷 键 。 


@ Reset 按钮 ， 从 下 拉 菜 单 中 选择 一 个 类 型 ， 然 后 点 击 Reset 恢复 成 默认 配置 。 


@ 搜索 框 ， 输 入 文字 按 操 作 名 称 进行 搜索 。 
按 快捷 键 搜索 ;点 击 Find Actions by Shortcut， 输 入 快捷 键 进行 搜索 。 


1.10 ”应 用 签名 


Android 要 求 所 有 APK 必须 先 使 用 证 书 进行 数字 签名 ， 然 后 才能 安装 。 


1.10.1 证 书 和 密 钥 库 


公 钥 证 书 〈 也 称 为 数字 证 书 或 身份 证 书 ) 包含 公 钥 / 私 钥 对 的 公 钥 ， 以 及 可 以 标识 密 钥 所 有 者 
的 一 些 其 他 元 数据 〈 例 如 名 称 和 位 置 ) 。 证 书 的 所 有 者 持 有 对 应 的 私 钥 。 
时 ， 签 名 工具 会 将 公 钥 证 书 附 加 到 APK。 公 和 钥 证 书 充当 “指纹 ”， 用 于 将 APK 
唯一 关联 到 你 以 及 对 应 的 私 钥 。 这 有 助 于 Android 确保 APK 的 任何 更 新 都 是 原版 更 新 并 来 自 原始 
作者 。 用 于 创建 此 证 书 的 密 钥 称 为 应 用 签名 密 钥 。 

密 钥 库 是 一 种 包含 一 个 或 多 个 私 钥 的 二 进 制 文件 。 











在 签名 APK 











每 个 应 用 在 








版 本 。 


整个 生命 周期 内 必须 使 用 相同 的 证 书 ， 以 便 用 户 能 够 以 应 用 更 新 的 形式 安装 新 
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1.10.2 ”调试 项 目 时 签名 





当 点 击 Android Studio 工具 栏 上 的 “Run 'app'” 按 钮 时 , Android Studio 将 自动 使 用 通过 Android 
SDK 工具 生成 的 测试 证 书签 名 你 的 APK。 

当 在 Android Studio 中 首次 运行 或 调试 项 目 时 ，IDE 将 自动 在 SHOME/.android/debug. 
keystore 中 创建 调试 密 钥 库 和 证 书 ， 并 设置 密 钥 库 和 密 钥 密 码 。 

由 于 测试 证 书 通过 构建 工具 创建 并 且 在 设计 上 不 安全 , 大 多 数 应 用 商店 (包括 Google Play 商 
店 ) 都 不 接受 使 用 调试 证 书签 名 要 发 布 的 APK。 

Android Studio 会 自动 将 你 的 测试 签名 信息 存储 在 签名 配置 中 ， 因 此 不 必 在 每 次 测试 时 都 输入 
此 信息 。 签 名 配置 是 一 种 包含 签名 APK 所 需 全 部 必要 信息 的 对 象 ， 这 些 信息 包括 密 钥 库 位 置 、 密 


1.10.3 正式 签名 


1. 生成 密 钥 和 密 钥 库 

使 用 Android Studio 生成 应 用 签名 或 上 传 密 铀 ， 有 具体 操作 步骤 如 下 : 

步骤 01 4 在 菜单 栏 中 点 击 Build*Generate Signed APK。 

步骤 024 从 下 拉 列 表 中 选择 一 个 模块 ， 然 后 点 击 “Next"。 

步骤 03Q 点 击 “Create new” 以 创建 一 个 新 密 钥 和 密 钥 库 。 

步骤 044 在 New Key Store 对 话 框 中 ， 需 要 填写 以 下 信息 ， 用 来 生成 密 钥 文件 ， 如 图 1-52 所 示 。 


oe New Key Store 














Key store path: /home/user/keystores/android.jks 


Password: ere0e00e Confirm: seveveee 
Key 

Alias: MyAndroidkey 

Password: seeeeeee Confirm: eeeeee 


Validity (years): 25j > 
Certificate 


First and Last Name: 。 FirstName LastName 


Organizational Unit: 。 Mobile Development 


Organization MyCompany 
City or Locality: MyTown 
State or Province: MyState 


Country Code 000: [US | 





Cancel 
图 1-52 新 建 密 钥 库 文件 


@ Key store path: 选择 创建 密 钥 库 的 位 置 。 
@ ”Password: 为 密 钥 库 创 建 并 确认 一 个 安全 的 密码 。 
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@ Alias: 为 密 钥 输入 一 个 标识 名 。 
@ Password: 为 密 钥 创建 并 确认 一 个 安全 的 密码 。 此 密码 应 当 与 密 钥 库 选 择 的 密码 不 同 。 
@ Validity (years ) 以 年 为 单位 设置 密 钥 的 有 效 时 长 。 密 钥 的 有 效 期 应 至 少 为 25 年 ， 可 以 在 应 
用 的 整个 生命 期 内 使 用 相同 的 密 钥 签 名 应 用 更 新 。 
@ Certificate: 为 证 书 输入 一 些 关 于 自己 的 信息 。 例 如 城市 、 国 家 、 姓 名 等 基本 信息 。 这 些 信息 
不 会 显示 在 应 用 中 ， 但 会 作为 APK 的 一 部 分 包含 在 证 书 中 。 
填写 完 表 单 后 , 点 击 OK 按钮 .这 时 证 书 已 经 生成 了 (在 选择 的 证 书 保 存 路 径 下 有 个 xxxjks 文件 )。 
如 果 想 继续 签名 App， 就 点 击 Next 按钮 ， 如 果 只 是 生成 一 个 签名 文件 ， 点 击 Cancel 按钮 。 
2. 手动 签名 APK 
Android Studio 可 以 手动 签名 APK， 也 可 以 在 Gradle 配置 文件 中 构建 签名 信息 ， 运 行 App 时 
对 APK 自动 签名 。 
要 在 App 中 手动 签名 APK， 操 作 步 骤 如 下 : 
步 又 014 点 击 Build 一 Generate Signed APK， 打 开 Generate Signed APK 对 话 框 ， 如 图 1-53 所 
示 。 选 择 刚 生成 的 jks 文件 、 密 钥 库 密码 、 密 钥 标 示 、 密 钥 密 码 ， 然 后 点 击 Next 按钮 。 








® 9 Generate Signed APK 
Key store path: /Users/ansen/Documents/myapplicationjks 


Key store password; e000e 

Key alias 123456 

Key password: eos 
Remember passwords 


?7 Cancel Provous 世 Z3 
图 1-53 ”签名 APK 


步骤 024 在 下 一 个 对 话 框 中 ， 选 择 APK 签名 之 后 保存 路 径 ， 同 时 可 以 选择 渠道 ， 由 于 我 们 
没有 配置 渠道 列表 ， 所 以 Flavors 一 栏 是 空 的 ， 接 下 来 选择 签名 版 本 ，V1 和 V2 都 选中 ， 然 后 点 击 
Finish 按钮 ， 如 图 1-54 所 示 。 


oe Generate Signed APK 
Note: Proguard settings are specified using the Project Structure Dialog 
APK Destination Folder。 | /Users/ansen/Documents/git/github/ MyApplication/app 





Build Type: release 日 
Flavors: 





Signature Version: V1 War Signature) WW v2 (FullfAPk Signature) Signature Help 


3 Cancel Previous 


图 1-54 生成 签名 配置 
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签名 完成 之 后 ， 就 会 在 选择 的 签名 文件 保存 路 径 下 生成 一 个 签名 之 后 的 APK 文件 ， 可 以 用 这 
个 APK 发 布 到 各 大 应 用 市 场 。 保 管 好 jks 文件 密码 ， 当 每 次 需要 更 新 版 本 到 应 用 市 场 时 ， 需 要 用 
这 个 jks 文件 进行 签名 。 

3. Gradle 自动 签名 

手动 签名 很 不 方便 ， 每 次 都 要 创建 APK，Google 早 就 想到 了 这 个 问题 ， 只 需要 在 build.gradle 
文件 中 加 几 行 代码 就 可 以 了 ， 以 后 每 次 运行 App 的 时 候 就 会 用 生成 的 jks 文件 签名 ， 而 不 是 临时 手 
动 签名 。 

使 用 自动 签名 需要 修改 app/build.gradle 文件 .在 Android 标签 下 增加 signingConfigs 标签 Cdebug 
与 release 版 本 签名 信息 设置 ) ， 如 图 1-55 所 示 。 
CaMyApolicaton Capp 个 buldgradle 


moet -e+ 
7 DMyApplication ~ 


© ManAciy ova x odConfo java x Androdvanilestaml x 





appty plugin: ‘com.android.application" 





本 卫 Pajec 






gradle 
» Didea 
conpllesdkyersion 25 
二 Y Capp baitdToosVersion "26.0.0" 
§ Dbuld 6 defauttConf1g { 
上 Dlibs appticationTd “com.ansen.nyapplication" 
Ee n ln5dkyersion 15 
国 9 targetSdkVersion 26 
加 DandroidTest versioncode 1 
Dmain vers: "Le 
Djava testInstrunentationRunner “android, support. test. runner.AndroidJUnitaunner"| 
上 Y 加 comansenm 
有 Ob MainA 77 
由 » Cares 6 
从 AndroidManifes 37 WR 
» Dtest heyPassword “1234 
repassvord "123455'/ 


.gitignore stal 祥 件 密 
ppm storeFile fi\e(*/Users/ansen/Docunents/myapplicatiod. jks*)// 特 文件 中 






» Obulld 

» 口 gmdle 

» Bmy-library-module 
.gitignore 9 buitdrypes { 


图 1-55 运行 App 自动 签名 


1.11 多 渠道 打包 








国内 提供 了 许多 应 用 市 场 ， 例 如 360、 百 度 、 应 用 宝 、 静 豆 莱 以 及 各 手机 厂商 的 市 场 等 。 

当 需 要 去 统计 App 的 下 载 量 、 激 活 量 的 时 候 ， 不 能 对 单个 市 场 的 流量 进行 统计 。 推 广 部 门 也 
不 知道 推广 效果 如 何 。 例 如 ， 今 天 App 在 应 用 宝 进行 了 首发 ， 需 要 统计 今天 应 用 宝 有 多 少 激活 设 
备 ， 有 多 少 注册 用 户 ， 这 样 才 知 道 推广 有 没有 效果 。 

为 了 解决 这 个 问题 就 出 现 了 多 渠道 打包 ， 一 份 源码 给 不 同 的 市 场 编译 出 不 同 的 APK 文件 ， 每 
个 APK 文件 中 都 包含 了 当前 市 场 的 渠道 码 (自己 指定 一 个 字符 串 〉。 





1.11.1 代码 实现 


修改 app/build.gradle 文件 ， 在 Android 标签 下 增加 productFlavors 标签 ， 内 容 如 下 : 
// 不 同 渠道 


productFlavors { 
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wandouj ia {// 豌 豆 莱 市 场 包 
// 自 定义 变量 ”参数 1 :变量 类 型 参数 2: 变 量 名 称 参数 3: 变 量 值 
buildConfigField "String", "FR", "\"wandoujia\"" 
} 
baidu {// 百 度 市 场 包 
buildConfigField "String", "FR", "\"baidu\"" 
| 
oppo {//oppo 市 场 包 
buildConfigField "String", "FR", "\"oppo\"" 
| 


我 们 就 自 定义 了 一 个 变量 FR， 不 同 的 渠道 赋值 不 同 的 字符 串 。 
这 个 自 定义 变量 会 在 BuildConfig 类 中 自动 生成 ， 在 Java 代码 中 取 这 个 值 只 要 一 行 代码 即 可 。 
String fr=BuildConfig .FR;// 取 到 当前 的 渠道 码 ， 然 后 上 传 到 服务 器 ， 就 能 根据 不 同 的 渠道 进行 统计 
Log.i("ansen", "当前 渠道 码 : "+fr); 

1.11.2 ”测试 


打 渠 道 包 必 须要 手动 进行 , 选择 需要 的 渠道 , 在 Android Studio 菜单 栏 中 点 击 Build 一 Generate 
Signed APK 一 Next， 如 图 1-56 所 示 。 


ee. Generate Signed APK 

Key store path: /Users /ansen/Documents /myapplication.jks 
Key store password: eeeeee 

Key alias: 123456 

Keypassword: e00000 


Remember passwords 


? Cancel Provions 29 
图 1-56 签名 APK 


输入 签名 信息 ， 点 击 Next 按钮 。 可 以 选择 APK 文件 输出 路 径 、 编 译 类 型 、 渠 道 包 。 渠 道 包 
可 以 多 选 ， 这 里 全 选 了 ， 然 后 点 击 Finish 按钮 ， 如 图 1-57 所 示 。 
四 9 Generate Signed APK 


Note: Proguard settlngs are specified using the Project Structure Dialog 
APK Destination Folder & /Users/ansen/Documents 


Build Type:__release 日 


baidu 





wandoujia 


Signature Versions: V1 (ar Signature) V2 (Full APK Signature) 。 Signature Help 


? Cancel Prevous E22 
图 1-57 签名 时 选择 渠道 码 


第 1 章 Android Studio 的 介绍 以 及 使 用 | 45 





Android Studio 编译 会 需要 一 点 时 间 ， 打 包 完 成 后 在 选择 的 APK 保存 路 径 下 会 生成 三 个 APK 
文件 ， 对 应 不 同 的 渠道 ， 如 图 1-58 所 示 ， 可 以 依次 安装 这 三 个 软件 包 。 看 打印 Logo， 会 发 现 安装 
不 同 的 包 打 印 的 女 值 是 不 一 样 的 。 





app-baidu- app-oppo- app-wandoujia- 


release apk release.apk release.apk 





图 1-58 不 同 渠 道 的 APK 文件 


多 渠道 还 能 干什么 
其 实 多 渠道 打包 还 能 干 很 多 事情 ， 比 如 给 不 同 的 渠道 配置 不 同 的 applicationId、 生 成 不 同 应 


用 名 称 或 图 标 ， 还 可 以 指定 不 同 渠 道 包 的 名 字 。 但 是 大 部 分 人 只 需要 打 渠 道 包 ， 如 果 想 实 
现 上 面 列 出 的 功能 ， 可 以 参考 Google 官方 文档 。 





1.12 ADB 详解 


ADB 的 全 称 为 Android Debug Bridge， 是 一 个 标准 的 CS 结构 工具 ， 用 于 连接 模拟 器 或 真 机 进 
行 调试 。 身 为 Android 开发 者 ， 熟 练 使 用 ADB 命令 将 会 大 大 提升 开发 效率 。 

在 电脑 上 会 运行 一 个 adb 进程 ， 用 于 扫描 5555~5585 之 间 的 奇数 端口 来 搜索 模拟 器 或 真 机 。 
- 旦 发 现 adb 守护 进程 ， 就 通过 此 端口 进行 连接 。 需 要 说 明 的 是 ， 每 一 个 模拟 器 或 真 机 使 用 一 对 端 
口 ， 奇 数 端口 用 于 adb 连接 ， 偶 数 端口 用 于 控制 台 连 接 。 

如 果 模 拟 器 与 adb 在 5555 端口 连接 ， 则 控制 台 的 连接 端口 将 是 5554。 


1.12.1 Mac 下 adb 加 入 环境 变量 (Windows 电脑 自行 搜索 ) 


首先 打开 terminal 终端 命令 窗口 ， 使 用 命令 [cd ~] 到 home 目录 下 : 
cd ~ 

接着 使 用 touch 命令 ， 这 个 命令 有 两 个 功能 : 

@ “如果 文件 存在 ， 把 已 存在 文件 的 时 间 标 签 更 新 为 系统 当前 的 时 间 。 
日 如 果 文件 不 存在 ， 就 创建 新 的 空 文件 。 

touch .bash profile 

然后 输入 如 下 命令 打开 文件 : 

open -e .bash profile 

在 打开 的 文件 最 后 增加 如 下 两 行 代码 再 保存 。 


export ANDROID SDK=/Users/ansen/Library/Android/sdk 
export PATH=${PATH}:${ANDROID SDK}/platform-tools 
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ANDROID_SDK 指向 的 路 径 需 要 替换 成 自己 的 sdk 路 径 。 随 便 打 开 一 个 项 目 ， 在 项 目 结构 页 


面 选 中 左 侧 的 SDK Location 就 能 看 到 本 地 的 sdk 路 径 : 


sdk location 
sdk_location 


最 后 用 [source .bash_profile] 命 令 使 用 修改 后 的 : 


source .bash profile 


验证 adb 环境 变量 是 否 配置 成 功 。 在 终端 输入 “adb version”， 如 果 显示 类 似 这 样 的 内 容 就 成 


功 了 : 


Android Debug Bridge version 1.0.39 
Revision 3db08f2c6889-android 
Installed as /Users/ansen/Library/Android/sdk/platform-tools/adb 


1.12.2 adb 常用 命令 


adb version: 查看 adb 版 本 。 

adb install: 安装 App。 

adb uninstall: 孝 载 App。 

adb push: 从 电脑 复制 东西 到 手机 设备 上 。 

adb pull: 从 设备 复制 东西 到 电脑 上 。 

adb logcat: 设备 的 日 志 。 

adb bugreport: 查看 bug 报告 。 

adb shell: 进入 设备 的 shell 命令 。 

adb devices: 列 出 所 有 连接 的 设备 ， 实 际 列 出 的 就 是 设备 的 serialnumber， 可 以 通过 -s 指定 列 
出 的 serialNumber 找到 对 应 的 设备 。 

adb start-server: 启动 adb server。 

adb kill-server: 停止 adb server。 

adb get-state: 列 出 设备 状态 ， 即 offline | bootloader | device。 
adb root: 获取 管理 员 权限 。 

adb shell dumpsys activity activities: 获取 当前 运行 的 Activity。 
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1.13 ”Android Studio 3.0 新 特性 


如 果 你 的 电脑 上 已 经 安装 了 Android Studio, 想 要 获取 最 新 版 本 , 点 击 Help 一 Check for update 


(如 果 是 Mac 系统 ， 点 击 Android Studio 一 Check for updates) 。 


且 本 


如 果 检 测 到 有 新 版 本 ， 会 弹出 一 个 对 话 框 ， 提 示 当 前 的 版 本 与 可 以 更 新 的 版 本 。 点 击 升级 并 
外 启 Android Studio 这 个 功能 。 接 下 来 会 自动 下 载 ， 安 装 完成 后 自动 重启 。 
如 果 还 没有 安装 过 ， 可 从 官网 页 面 下 载 : https://developer.android.google.cn/studio/index.html。 








第 1 章 Android Studio 的 介绍 以 及 使 用 | 47 





目前 的 Android Studio 3.0 是 一 个 重要 版 本 ， 包 含 许多 新 功能 以 及 旧 功 能 改进 。 
MAC 用 户 在 更 新 Android Studio 时 ， 可 能 会 遇 到 一 个 更 新 错误 对 话 框 ， 指 出 “在 安装 过 程 中 
发 生 冲 突 ”。 不 需要 管 它 ， 直 接点 击 “ 取 消 ”继续 安装 即 可 。 


1.13.1 Android Gradle 插件 3.0.0 


Gradle 3.0 包含 新 功能 并 且 改 进 了 旧 功 能 ， 可 为 包含 大 量 module 的 项 目 提高 构建 性 能 。 使 用 
Gradle 3.0 版 本 开发 大 型 项 目 ， 主 要 具有 以 下 优点 : 
对 代码 或 资源 进行 简单 修改 ， 编 译 时 间 更 快 。 
支持 Android 8.0。 
支持 基于 语言 资源 构建 单独 的 APK。 
支持 Java 8。 
改进 了 ndk-build 和 cmake 的 构建 速度 。 
改进 Gradle 同步 速度 。 
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1.13.2 手动 更 新 Gradle 版 本 


(1) 修改 gradle-wrapper.properties 文件 中 distributionUrl 的 值 : 


distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all. 
zip 


(2) 修改 项 目 根 目录 build.gradle 文件 ， 把 Gradle 插件 版 本 改 成 3.0.0: 


buildscript { 
repositories { 
jcenter () 
n 
dependencies { 
classpath 'com.android.tools.build:gradle:3.0.0"' 


// NOTE: Do not place your application dependencies here; they belong 
// in the individual module build.gradle files 
} 


1.13.3 ”Kotlin 支持 


正如 Google IO 2017 宣布 的 那样 ，Kotlin 编程 语言 在 Android 上 正式 得 到 支持 。 因 此 ， 在 这 
个 版 本 中 ，Android Studio 包含 了 Android 开发 的 Kotlin 语言 支持 。 

通过 将 Java 文件 转换 为 Kotlin (点 击 代码 一 Convert Java File to Kotlin File) 或 者 使 用 New 
Project 创建 一 个 新 的 Kotlin 的 项 目 ， 可 以 将 Kotlin 合并 到 项 目 中 ， 如 图 1-59 所 示 。 
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Create(savedIn e: Bundle?) { 


) 
) Toolbar 


Enter action or option name: FloatingActionButton 


Q Convert Java File to 


[Convert Java File to CU TT D2 Code 
Wir 


) .show() 





1-59 Java 转 Kotlin 


1.13.4 Java 8 支持 


现在 可 以 使 用 Java 8 的 某 些 语法 ， 并 且 可 以 使 用 Java 8 构建 的 库 。 
如 果 想 要 项 目 支持 Java 8， 点 击 File 一 Project Structure。 在 Project Structure 对 话 框 中 将 Source 
Compatibility 与 Target Compatibility 都 选择 1.8， 如 图 1-60 所 示 。 








D prolect 





图 1-60 项 目 支 持 Java 8 


1.13.5 Android Profiler 


新 的 Android Profiler 蔡 代 了 Android Monitor, 提供 一 套 新 的 工具 , 实时 测试 应 用 程序 的 CPU、 
内 存 、 网 络 使 用 情况 ， 如 图 1-61 所 示 。 还 可 以 取代 抓 包工 具 ， 能 够 查看 网 络 传输 的 具体 细节 。 

要 打开 这 个 工具 ， 点 击 View 一 Tool Windows 一 Android Profiler (如 果 toolbar 上 有 ， 直 接点 击 
Android Profiler) 。 


当 Android Profiler 工具 显示 时 ，Logcat 会 隐藏 ， 在 Toolbar 上 可 以 看 到 。 
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图 1-61 Android Profiler 查看 CPU、 内 存 、 网 络 使 用 情况 


从 上 到 下 一 共 分 三 块 : CPU、 内 存 、 网 络 。 如 果 想 分 享 具体 的 某 一 个 ， 点 击 就 会 显示 具体 细 
节 。 


1.13.6 CPU Profiler 


CPU Profiler 主要 用 于 分 析 应 用 程序 的 CPU 线程 使 用 情况 ， 如 图 1-62 所 示 。 









































图 1-62 ”CPU 使 用 分 析 


1.13.7 ”Memory Profiler 


Memory Profiler 显示 了 应 用 程序 内 存 使 用 情况 ， 并 且 用 图 形 界面 表示 ， 可 以 捕捉 堆 的 存储 、 
垃圾 内 存 回 收 以 及 内 存 分 配 跟踪 ， 如 图 1-63 所 示 。 
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图 1-63 内存 分 析 


1.13.8 Network Profiler 


Network Profiler 显示 请 求 链接 地 址 、 时 间 、 状 态 码 以 及 请 求 回 来 的 数据 ， 如 图 1-64 所 示 。 完 
全 可 以 用 这 个 替代 抓 包工 具 。 





图 1-64 网 络 访问 情况 


1.13.9 APK profiling 


如 果 想 看 apk 文件 的 资源 文件 , 不 需要 用 apktool 工具 了 , Android Studio 3.0 支持 直接 打开 apk 
文件 ， 只 要 双击 apk 文件 即 可 ， 如 图 1-65 所 示 。 





第 1 章 Android Studio 的 介绍 以 及 使 用 | 51 





paoct = 加 计生 吕 aoo-seoaaek a 
radle Fiesunder the "build" folder are generated and shouid not be edited. 2 
ee com.weiyi.nursing.mobilenursing (vers.on 30) | 

bu © Row pie Size: 3.1 MB, Downioad Size: 2.6 MB Compare with previous APK, 














下 而 过 Load Proguard mappings... This dex fle defines 3392 classes with 24976 methods an 





图 1-65 apk 文件 分 析 
可 以 看 到 apk 文件 中 res 文件 夹 下 的 资源 ， 还 能 够 看 到 各 个 文件 占 比 大 小 。 
1.13.10 Device File Explorer 
新 的 设备 文件 管理 器 允许 设备 与 计算 机 之 间 进 行文 件 传输 。 如 果 要 打开 手机 上 的 文件 ， 双 击 


文件 即 可 。 选 择 方便 ， 不 像 之 前 还 要 用 adb 命令 。 
如 果 要 打开 设备 文件 管理 ， 点击 View 一 Tool Windows 一 Device File Explorer， 如 图 1-66 所 示 。 





图 1-66 设备 文件 管理 
1.13.11 Adaptive Icons wizard 

Image Asset Studio 现在 支持 矢量 绘图 ， 可 以 为 Android 8.0 创建 自 适应 启动 Icon， 同 时 可 以 为 
8.0 以 下 的 手机 创建 传统 图 标 。 


右 击 项 目 中 的 res 文件 夹 ， 选 择 New 一 Image Asset。 在 Asset Studio 对 话 框 中 ， 选 择 Launcher 
Icons (Adaptive and Legacy) 作为 图 标 类 型 ， 如 图 1-67 所 示 。 
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图 1-67 矢量 绘图 


1.13.12 ”Google 的 Maven 存储 库 


Android Studio 现在 默认 使 用 Google 的 Maven 存储 库 ， 而 不 是 依赖 Android SDK Manager 来 
获取 Android 支持 库 、Google Play 服务 、Firebase 和 其 他 依赖 项 的 更 新 。 这 样 更 新 更 加 方便 ， 特 别 
是 在 使 用 持续 集成 〈CI) 系统 时 。 

现在 新 项 目 默 认 会 添加 Google Maven 存储 库 。 如 果 需 要 更 新 之 前 的 项 目 ， 打 开 项 目下 的 
build.gradle 文件 。 在 allprojects 标签 中 增加 google()。 


allprojects { 
repositories { 
google () // 增 加 这 行 代码 
jcenter () 


1.14 ”本章 小 结 


本 章 主 要 学 习 Android Studio 的 基本 使 用 方法 ， 包 括 如 何 创建 项 目 、 运 行 项 目 、 调 试 项 目 。 接 
下 来 慢 慢 熟悉 项 目 结构 ， 用 Android Studio 运行 第 一 个 应 用 程序 Hello World， 当 这 个 Hello World 
显示 在 Android 手机 上 时 ， 有 没有 觉得 很 有 趣 呢 ? 当然 ， 跟 市 场 上 的 应 用 程序 相 比 ， 这 个 应 用 太 简 
单 了 。 不 过 ， 很 多 人 学 习 Java 时 ， 也 是 从 Hello World 开始 一 步 一 步 过 来 的 。 学 完 本 章 也 算 加 入 
Android 开发 的 大 军 啦 ， 大 家 继续 努力 加 油 ， 后 面 的 内 容 更 加 精彩 ! 





第 2 章 


Android 控件 


本 章 主要 介绍 Android 中 常用 的 控件 及 其 使 用 方法 ，Android SDK 本 身 给 我 们 提供 大 量 的 UI 
控件 , 合理 熟练 地 使 用 这 些 控件 才能 做 出 优美 的 界面 。 有 时 候 Android 自 带 的 控件 不 一 定 能 满足 业 
务 需求 ， 所 以 本 章 还 会 介绍 自 定义 控件 。 


2.1 View 介绍 


在 Android 开发 中 ，Android 的 UI 界面 都 是 由 View 及 其 派生 类 组 合 而 成 的 。View 类 几乎 包 
含 了 所 有 的 屏幕 类 型 ， 每 一 个 View 都 有 一 个 用 于 绘图 的 画布 。 画 布 可 以 进行 任意 扩展 ， 只 需要 重 
写 onDraw 方法 ， 就 能 绘制 界面 显示 。 界 面 既 可 以 是 复杂 的 3D 效果 ,也 可 以 只 是 简单 的 文本 显示 。 
表 2-1 描述 了 View 常用 的 XML 属性 及 相关 方法 。 


表 2-1 View 常用 的 XML 属性 及 相关 方法 
XML 属性 相关 方法 说 明 








android:id setld(inb) 给 当前 View 设置 一 个 在 当前 xxx.xml 中 的 唯一 
编号 ， 可 以 通过 调用 View.findViewByld0 或 
Activity findViewById0 根 据 编号 查找 到 对 应 的 
View。 不 同 的 layoutxml 之 间 定 义 相同 的 id 不 








会 冲突 
android:clickable setClickable(boolean 是 否 响 应 点 击 事件 
clickable) @ clickable=true: 允许 
@ clickable=false: 禁止 
android:longClickable setLongClickable(boolean ”| 是 否 响 应 长 点 击 事件 
clickable) @ clickable=true: 允许 


@ clickable=false: 禁止 
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( 续 表 ) 





XML 属性 相关 方法 说 明 
android:backgroud setBackgroundColor 设置 背景 颜色 





android:visibility setVisibility 是 否 可 见 

@ Visible: 默认 值 ， 可 见 

e@ Invisible: 不 可 见 

e@ Gone: 不 可 见 ， 并 且 在 屏幕 中 不 占 位 置 
设置 滚动 条 显示 

e@ None: 隐藏 ， 不 可 见 

e@ Horizontal: 水平 

e@ Vertical， 垂直 

在 xml 中 给 onclik 设置 什 | 设置 点 击 事件 

么 值 ， 在 对 应 的 Activity 






android:scrollbars 


android:onClick 





中 写 对 应 的 方法 。 例 如 : 

android:onClick="test"， 在 
Activity 中 写 对 应 的 方法 
public void test(View 





view) 0 

设置 上 下 左右 内 边 距 
|androidipaddingTop ”| | 设置 项 部 内 边 距 
|android:paddingBotom | | 设置 底部 内 边 距 
|androidipaddingLeh | | 设置 上 过 过 下 
|androidipaddingRight | | 设置 右边 内 边 下 
[androidilayout margin | | 设置 外 边 下 
|androidilayout marginTop | | 设置 项 部 外 边 距 
| androidiayout marginBottom 。 | | 设置 底 部 外 边 距 
|androidilayout marginLeh | | 设置 左边 外 边 距 
|androidilayout marginRight 。 | | 设置 右边 外 边 距 
setMinimumHeight(int) 设置 视图 最 小 高 度 
android:min Width setMinimum Width(int) 设置 视图 最 小 宽度 


View 是 所 有 UI 组 件 的 基 类 ,一般 来 说 ,开发 Android 应 用 程序 的 UI 界面 都 不 会 直接 使 用 View， 
而 是 使 用 派生 类 。 

View 派生 出 的 直接 子 类 有 ImageView、TextView、ViewGroup、ProgressBar 等 。 

View 派生 出 的 间接 子 类 有 AbsListView、Button、Edittext、CheckBox 等 。 

使 用 系统 给 我 们 提供 的 View 派生 类 能 实现 开发 中 的 大 部 分 需求 , 但 是 有 时 候 需 要 针对 业务 需 
求 去 定制 View， 例 如 画 饼 状 图 、 折 线 图 、 贝 塞 尔 曲 线 等 。 








2.1.1 自 定义 View 


我 们 要 实现 的 效果 就 是 一 个 画 圆 的 过 程 ， 在 增加 圆 形 弧 度 的 同时 改变 圆 的 颜色 〈 颜 色 随机 生 
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成 ) 。 如 果 弧 度 大 于 360”， 就 重新 开始 画 ， 一 直 循环 。 每 次 增加 的 弧度 根据 xml 文件 设置 ， 不 需 
要 修改 Java 代码 ， 运 行 效果 如 图 2-1 所 示 。 


ED] 


AnsenView AnsenView 





图 2-1 自 定义 View 运行 效果 


新 建 一 个 项 目 ， 在 项 目下 建 一 个 MyView 类 ， 继 承 自 View。 重 写 构造 方法 和 onDraw 方法 。 


Public class MyView extends View{ 
private MyThread myThread; 


private Paint paint;// 画 笔 


private RectF rectF=new RectF(150,150,380,380); 
private int sweepAngle=0;// 弧 的 当前 度数 

private int sweepAngleAdd=20;// 弧 每 次 增加 度数 
Private Random random=new Random(); 

private boolean running=true;// 控 制 循 环 


public MyView (Context context) { 
this(context,null); 
} 


Public MyView(Context context,AttributeSet attrs) { 
super (context, attrs); 
init (context,attrs); 

} 


// 初 始 化 

Private void init(Context context,AttributeSet attrs){ 
paint=new Paint(); 
paint.setTextSize(60); 

和 


QOverride 
Protected void onDraw (Canvas canvas){ 
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Log.i("MyView","onDraw"); 
if (null==myThread){ 
myThread=new MyThread(); 
myThread. start (); 
J}else{ 
// 第 一 个 参数 是 RectF 左上 的 x y 坐标 ” 右 下 的 x y 坐标 
// 第 二 个 参数 是 弧 形 的 开始 角度 
// 第 三 个 参数 是 弧 形 的 结束 角度 
// 第 四 个 参数 是 true : 画 扇形 ” false: 画 弧 线 
// 第 五 个 参数 是 画笔 


canvas .drawRrc (rectF, 0, sweepAngle, true, paint); 
| 
// 开 启 一 个 子 线程 绘制 ui 


Private class MyThread extends Thread{ 
@Override 
public void run() { 
while(running){ 
logic(); 
PostInvalidate () ;// 重 新 绘制 ,会 调用 onDraw 
try { 
Thread.sleep (200); 
} catch (InterruptedException e) { 
e.PrintStackTrace (); 
} 


E 


protected void logic() { 
sweepAngle+=sweepAngleAdd;// 每 次 增加 弧度 


// 随 机 设置 画笔 的 颜色 

int r=random.nextInt(255); 
int g=random.nextInt(255); 
int b=random.nextInt(255); 
paint.setARGB(255, r, g, b); 


if (sweepAngle>=360) {// 如 果 弧度 大 于 360° 就 从 头 开 始 
sweepAngle=0; 
1 
} 


@Override 
Protected void onDetachedFromWindow() { 


running=false;// 销 毁 View 的 时 候 设置 成 false, 退出 无 限 循环 


Super .onDetachedFromWindow() 7 
时 
我 们 在 构造 方法 中 初始 化 画笔 ，View 第 一 次 绘制 在 界面 上 时 会 调用 onDraw 方法 。 我 们 首先 


判断 当前 的 线程 是 否 为 室 ， 第 一 次 运行 myThread 肯定 是 空 的 ， 于 是 开启 线程 。 如 果 不 为 空 就 绘制 
圆 。 
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启动 MyThread 线程 时 ， 会 调用 run 方法 。 在 run 方法 中 用 一 个 变量 控制 循环 ， 默 认 是 true， 
只 要 我 们 没有 改变 这 个 变量 的 值 为 false， 就 是 一 个 死 循 环 。 在 循环 中 调用 logic 方法 ， 同 时 调用 
View 自 带 的 postInvalidate 方法 重新 绘制 界面 。 最 后 延迟 200 毫秒 。 

logic 方法 中 增加 圆 形 的 弧度 ， 设 置 画笔 的 颜色 。 最 后 判断 一 下 弧度 是 不 是 大 于 360”， 如 果 
大 于 360” 就 从 0 重新 开始 。 

onDetachedFromWindow 方法 是 View 生命 周期 里 面 的 一 个 方法 ， 在 View 销毁 的 时 候 调用 。 
改变 running 变量 的 值 为 false， 这 样 线程 就 会 退出 死 循 环 。 


1. View 测量 ( 重 写 onMeasure 方法 ) 


讲 到 View 的 measure 测量 ， 会 涉及 View 的 一 个 静态 内 部 类 MeasureSpec，MeasureSpec 类 封 
装 了 父 View 传递 给 子 View 的 布局 (layout) 要 求 ， 每 个 MeasureSpec 实例 代表 宽度 或 者 高 度 (只 
能 是 其 一 ) 要 求 。MeasureSpec 的 字面 意思 是 测量 规格 或 者 测量 属性 ， 在 measure 方法 中 有 两 个 参 
数 widthMeasureSpec 和 heightMeasureSpec 。 如 果 使 用 widthMeasureSpec， 我 们 就 可 以 通过 
MeasureSpec 计算 出 宽度 模式 Mode 和 宽度 的 实际 值 。 
测量 的 模式 分 以 下 三 种 : 
@ ”EXACTLY: 精确 值 模式 。 当 View 的 layout_width 或 者 layout_height 属性 设置 为 具体 的 数值 
(例如 ，android:layout_width = "100dp" ) 或 者 指定 为 “match_parent” 时 (系统 会 自动 分 配 
为 父 布局 的 大 小 ) 使 用 的 模式 。 
e@ AT MOST: 最 大 值 模式 。 当 View 的 layout width 或 者 layout_ height 属性 设置 为 
“wrap_content" 时 使 用 的 模式 。 
ee UNSPECIFIED: 可 以 将 视图 按照 自己 的 意愿 设置 成 任意 大 小 ， 没 有 任何 限制 。 这 种 情况 比较 
少见 ， 很 少 用 到 。 





2. 为 什么 要 重 写 onMeasure 方法 
我 们 修改 一 下 activity_main.xml: 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/ 
res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


AnsenView 


<com.ansen.view.MyView 


android:background="@android:color/holo green 
dark" 
android:layout width="wrap content" 


android:layout height="wrap content"/> 
</RelativeLayout> 


最 外 层 用 RelativeLayout， 里 面 用 了 我 们 自 定义 的 
View， 运 行 效果 如 图 2-3 所 示 。 





图 2-3 未 重 写 onMeasure 方法 运行 效果 图 
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从 布局 文件 中 可 以 看 到 明明 设置 了 android:layout ”width="wrap_content"， 但 是 背景 颜色 的 宽 


高 跟 屏幕 一 样 大 。 所 以 我 们 得 重 写 onMeasure 方法 : 


QOverride 


Protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec){ 


// 获 得 父 容器 为 它 设置 的 测量 模式 和 大 小 


int widthMode = MeasureSpec.getMode (widthMeasureSpec); 
int widthSize = MeasureSpec.getSize (widthMeasureSpec); 


int heightMode 
int heightSize 


Le 


int width; 
int height ，; 


MeasureSpec.getMode (heightMeasureSpec) 
MeasureSpec.getSize (heightMeasureSpec) 


if (widthMode == MeasureSpec.EXACTLY) {// 指 定 宽度 或 者 match parent 


width = widthSize; 
} elsef 


width = (int) (getPaddingLeft() + getPaddingRight () + rectF.width()*2); 


| 


if (heightMode == MeasureSpec.EXACTLY) {// 指 定 高 度 或 者 match parent 


height = heightSize; 
} else{ 


height = (int) (getPaddingTop()+getPaddingBottom()+rectF.height ()*2); 


ee (width, height); 

} 

首先 获取 宽 高 模式 以 及 父 容器 为 这 个 View 分 配 的 宽 
高 ， 然 后 判断 宽 高 的 类 型 ， 因 为 在 布局 文件 中 设置 的 是 
wrap_content， 所 以 都 会 执行 else 语句 。 宽 度 是 圆 形 的 2 
倍 ， 高 度 也 是 圆 形 的 2 倍 ，View 的 宽 高 只 有 是 圆 形 的 两 
倍 才 能 看 到 圆 形 以 外 的 绿色 背景 。 最 后 调用 
setMeasuredDimension 传 入 测量 之 后 的 宽 高 。 重 新 运行 代 
码 ， 效 果 如 图 2-4 所 示 。 从 效果 图 中 可 以 看 到 显示 正常 。 

为 什么 我 们 的 圆 形 画 在 背景 颜色 区 域 的 右 下 角 ? 因 
为 RectF 的 left 跟 top 都 是 从 190 开始 的 。 如 果 想 画 在 左 
上 和 角 应 该 怎么 做 呢 ? 其 实 很 简单 ， 只 需要 修改 RectF 的 初 
始 值 即 可 。 

Private RectF rectF=new RectF (0,0,190,190) 

这 样 改 了 之 后 就 从 (0,0) 坐标 画 圆 ， 并 且 圆 形 的 宽 高 
还 是 190。View 的 宽 高 是 圆 形 的 两 倍 ， 还 是 380。 


2.1.2 自 定义 属性 


首先 在 res/values 下 新 建 一 个 attrs.xml 文件 。 内 容 如 下 : 


AnsenView 








图 2-4 重 写 onMeasure 方法 后 运行 效果 图 
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<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<declare-styleable name="customStyleView"> 
<attr name="sweepAngleAdd" format="integer"/> 
</declare-styleable> 
</resources> 


其 中 ，name 为 属性 集 的 名 字 ， 主 要 用 途 是 标识 属性 集 ， attr 标签 可 以 有 多 个 ，format 属性 对 
应 的 类 型 也 有 很 多 ， 例 如 string、integer、dimension、reference、color、enum， 这 里 使 用 integer。 
在 布局 xml 文件 中 引用 我 们 刚刚 自 定 义 的 属性 。activity_main.xml 在 修改 之 后 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:custom="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.ansen.view.MyView 
android:background="@android:color/holo green dark" 
android:layout width="wrap content" 
android:layout height="wrap content" 
custom: sweepAngleAdd="10"/> 
</RelativeLayout> 
这 里 只 增加 了 两 行 代码 ， 即 最 外 层 的 RelativeLayout 增加 了 自 定义 View 的 命名 空间 。 之 后 ， 
在 自 定义 View 中 就 可 以 使 用 custom:sweepAngleAdd 属性 了 。 
接 下 来 在 MyView 类 的 init 方法 中 获取 sweepAngleAdd 的 值 。 
// 获 取 自 定义 属性 的 值 
TypedArray typPedRArray=Ccontext.obtainStyledRttributes (attrs, 
R.styleable.customStyleView); 
sweepAngleAdd=typedArray.getInt (R.styleable.customStyleView sweepAngleAdd, 
0); 
typedArray.recycle(); 
这 样 做 的 好 处 就 是 如 果 我 们 想 改 变 圆 形 每 次 增加 的 弧度 大 小 ， 只 需要 修改 xml 文件 即 可 ,不 
需要 修改 自 定义 View 的 Java 代码 ， 达 到 封装 的 效果 。 


2.2 ViewGroup 介绍 


做 过 Android 应 用 开发 的 朋友 都 知道 ，Android 的 UI 界面 都 是 由 View 和 ViewGroup 及 其 派 
生 类 组 合 而 成 的 。 其 中 ，View 是 所 有 UI 组 件 的 基 类 ， 而 ViewGroup 是 容纳 这 些 组 件 的 容器 ， 其 
本 身 也 是 从 View 派生 出 来 的 。 

AndroidUI 界面 的 一 般 结构 可 参见 图 2-5。 

可 见 ， 作 为 容器 的 ViewGroup 可 以 包含 作为 叶子 节点 的 View， 也 可 以 包含 作为 更 低层 次 的 子 
ViewGroup， 而 子 ViewGroup 又 可 以 包含 下 一 层 的 叶子 节点 的 View 和 ViewGroup。 事 实 上 ， 这 种 
灵活 的 View 层次 结构 可 以 形成 非常 复杂 的 UI 布局 , 开发 者 可 据 此 设计 、 开 发 非常 精致 的 UI 界面 。 
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图 2-5 ViewGroup 如 何在 布局 中 形成 分 支 并 容纳 其 他 View 的 图 解 


一 般 来 说 ， 开 发 Android 应 用 程序 的 UI 界面 都 不 会 直接 使 用 ViewGroup， 而 是 使 用 它 的 派生 
类 。 

ViewGroup 派生 出 的 直接 子 类 有 CoordinatorLayout、DrawerLayout、 RecyclerView, FrameLayou、 
LinearLayout、RelativeLayout、SwipeRefreshLayout、ViewPager 等 。 

ViewGroup 派生 出 的 间接 子 类 有 GridView、ListView，WebView 等 。 


2.2.1 自 定义 ViewGroup 


在 前 面 的 内 容 中 , 我 们 学 习 过 如 何 自 定义 View。 自 定义 ViewGroup 跟 自 定义 View 有 点 类 似 。 
- 般 情况 下 自 定义 ViewGroup 会 重 写 以 下 几 个 方法 : 
®@ ”onMeasure 测量 子 View 的 宽 高 ， 根 据 子 View 的 宽 高 与 自己 的 测量 模式 来 决定 自己 的 宽 高 。 
@ ”onLayout 决定 子 View 的 摆 放 位 置 。 
”generateLayoutParams 根据 子 View 的 布局 参数 决定 子 View 在 当前 容器 的 摆 放 位 置 ， 这 个 方 
法 根据 需求 决定 要 不 要 重 写 。 


1. 首先 实现 LinearLayout 布局 的 水 平 排列 效果 


实现 这 种 效果 只 需要 重 写 onLayout 和 onMeasure 方法 ， 这 里 新 建 一 个 类 MyViewGroup， 继 承 
自 ViewGroup 。 


Public class MyViewGroup extends ViewGroup{ 
Public MyViewGroup (Context context) { 
super (context); 
} 


Public MyViewGroup (Context context, AttributeSet attrs) { 
super (context,attrs); 
上 


@Override 

Protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec) { 
// 获 取 ViewGroup 宽 高 
int sizeWidth = MeasureSpec.getSize (widthMeasureSpec); 
int sizeHeight = MeasureSpec.getSize (heightMeasureSpec); 
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measureChildren (widthMeasureSpecvheightMeasureSpec) 


// 测 量 所 有 子 View 的 宽 高 


Log.i("ansen", "测量 宽度 :"+sizewidth+"” 测量 高 度 :"+sizeHeight); 
setMeasuredDimension(sizeWidth,sizeHeight); 


@Override 
Protected void onLayout (boolean changed, int 1, int t, int r, int b) { 
int count=getChildCount () ;// 获 取 子 View 数量 
int left=0; 
for (int i=0;i<count;i++){ 
View child=getChildAt (i); 


int childWidth=child.getMeasuredWidth() ;// 获 取 子 View 宽度 
int childHeight=child.getMeasuredHeight () ;// 获 取 子 View 高 度 


child.layout (left,0,left+childwidth,childHeight);// 设 置 摆 放 位 置 
left+=childwidth;// 


: 

执行 流程 是 在 onMeasure 方法 调用 两 遍 之 后 再 调用 onLayout 方法 。 首 先 我 们 看 onMeasure 方 
法 ,， 跟 之 前 自 定义 View 时 有 点 类 似 , 没有 使 用 过 的 就 只 有 measureChildren 方法 。measureChildren 
方法 的 作用 是 测量 所 有 子 View 的 宽 高 。 

接 下 来 看 onLayout。 先 获取 所 有 的 子 View, 用 for 循环 进行 迭代 ,调用 View 的 getMeasuredWidth 
与 getMeasuredHeight 方法 获取 子 View 的 测量 宽度 和 高 度 。 注 意 ， 这 里 不 能 调用 getWidth 和 
getHeight， 这 两 个 方法 必须 在 onLayout 执行 完 才能 调用 ， 不 然 返回 都 是 0。 最 后 两 行 代码 连 起 来 
看 ， 在 child.layout 这 行 代码 中 ，layout 方 法 有 4 个 参数 ， 分 别 是 Left、Top、Right、Bottom， 分 别 
表示 当前 View 在 Viewgoup 中 显示 的 位 置 .普及 一 下 ,在 Android 手机 上 屏幕 的 左上 角 坐 标 是 [0.0]， 
测量 之 后 给 left 加 上 当前 View 的 宽度 ， 这 样 就 能 水 平 进行 排列 。 

然后 看 布局 文件 activity_ main.xml， 将 布局 换 成 了 我 们 自己 写 的 MyViewGroup， 里 面 放 了 3 


个 TextView。 





<com.ansen.views.MyViewGroup 
xmlns:android="http://schemas.android.com/apk/res/ android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="Q@android:color/darker gray"> 


<TextView 
android:layout width="60dp" 
android:layout height="60dp" 
android:background="@android:color/holo red light" 
android:padding="10dp" 
android:text="1"/> 


<TextView 
android:layout width="60dp" 
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android:layout height="80dp" 
android:background="@android:color/holo blue light" 
android:padding="10dp" 

android:text="2" /> 


<TextView 

android:layout width="40dp" 

android:layout height="60dp" 

android:background="@android:color/holo orange light" 

android:padding="10dp" 

android:text="3" 

android:textColor="@android:color/white"/> 
</com.ansen.views .MyViewGroup> 


运行 代码 ， 效 果 如 图 2-6 所 示 。 


ViewGroup 





2-6 自 定义 ViewGroup 实现 LinearLayout 布局 水 平 排列 效果 


如 果 所 有 子 View 的 宽度 之 和 超过 屏幕 宽度 ， 就 会 显示 非 正常 效果 。 这 个 案例 主要 以 学 习 为 
主 。 





2. 测量 ViewGroup 宽 高 


如 果 我 们 把 activity_ main.xml 文件 中 MyViewGroup 控件 的 android:layout_ width 和 
android:layout_height 属性 的 值 改 成 wrap_content， 就 会 发 现 ViewGroup 的 宽 高 还 是 填充 整个 屏幕 ， 
所 以 需要 重新 修改 onMeasure 方法 。 


@Override 

protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec) { 
// 获 得 此 ViewGroup 计算 模式 
int widthMode = MeasureSpec.getMode (widthMeasureSpec); 
int heightMode = MeasureSpec.getMode (heightMeasureSpec); 
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// 获 取 ViewGroup 宽 高 
int sizeWidth = MeasureSpec.getSize (widthMeasureSpec) ; 
int sizeHeight = MeasureSpec.getSize (heightMeasureSpec) ; 


measureChildren (widthMeasureSpec, heightMeasureSpec) ;// 测 量 所 有 子 View 的 宽 高 


if (getchildCount ()<=0) {// 如 果 没 有 子 View 当前 ViewGroup 的 宽 高 直接 设置 为 0 
setMeasuredDimension(0,0); 
}else if (heightMode==MeasureSpec.AT MOST&&widthMode== 
MeasureSpec.AT MOST){ // 宽 和 高 是 wrap content 
int measuredwidth=0;// 测 量 宽度 
int maxMeasuredHeigh=0;// 测 量 高 度 子 View 最 大 的 高 度 
for (int i=0;i<getChildCount () ;i++)1{ 
View child=getChildAt (i); 


measuredWidth+=child.getMeasuredWidqdth(); 


if(child.getMeasuredHeight () >maxMeasuredHeigh){ 
// 如 果 当 前 的 View 大 于 之 后 View 的 高 度 
maxMeasuredHeigh=child.getMeasuredHeight (); 
} 
} 
setMeasuredDimension (measuredWidth,maxMeasuredHeigh); 
}elsel{ 
setMeasuredDimension(sizeWidth,sizeHeight); 
} 
} 


首先 获取 ViewGroup 计算 模式 ， 如 果 宽 和 高 都 是 wrap_content， 壕 代 子 View， 所 有 子 View 
的 宽度 加 起 来 等 于 ViewGroup 的 宽度 ， 高 度 取 子 View 中 最 高 的 值 。 重 新 运行 代码 ， 效 果 如 图 2-7 
所 示 ， 因 为 给 ViewGroup 设置 了 一 个 灰色 的 背景 ， 所 以 明显 地 看 到 ViewGroup 的 宽 高 正 是 我 们 想 
要 的 。 


ViewGroup 








2.7 ViewGroup 宽 高 根据 子 View 来 决定 
3. 自 定义 LayoutParams 


我 们 在 前 面 用 LinearLayout 布局 时 ， 子 View 使 用 了 android:layout_weight 属性 ， 通 过 
layout_weight 属性 来 决定 当前 View 在 LinearLayout 中 的 占 比 ， 这 也 是 因为 LinearLayout 源码 中 重 
写 了 generateLayoutParams 方法 。 

还 有 一 种 情况 就 是 所 有 的 控件 都 有 android:layout_margin 属性 , 可 以 通过 这 个 属性 来 设置 控件 
之 间 的 间距 ， 这 是 因为 ViewGroup 中 封装 了 MarginLayoutParams 静态 类 。 














64 | Android App 开发 从 入 门 到 精通 





首先 在 res/values 文件 夹 下 新 建 attrs.xml 文件 ， 自 定义 属性 ， 有 两 个 值 right 和 bottom，Fright 
让 当前 View 显示 在 ViewGroup 右边 ，bottom 让 当前 View 显示 在 ViewGroup 左边 ， 内 容 如 下 : 


<?xml Version="1.0" encoding="utf-8"?> 
<resources> 
<declare-styleable name="CustomLayoutLP"> 
<attr name="layout position"> 
<enum name="right" value="]1" /> 
<enum name="bottom" value="2" /> 
</attr> 
</declare-styleable> 
</resources> 


在 MyViewGroup 中 新 建 静态 内 部 类 ， 因 为 我 们 自 定 义 的 ViewGroup 肯定 也 要 设置 子 View 之 
间 的 间距 ， 所 以 直接 继承 MarginLayoutParams， 然 后 重 写 generateLayoutParams 返回 我 们 自己 重 写 
的 MyLayoutParams。 在 构造 方法 中 把 layout position 的 值 取出 来 赋值 给 position 变量 。 

@Override 


Public ViewGroup.LayoutParams generateLayoutParams (AttributeSet attrs){ 
return new MyLayoutParams (getContext (), attrs); 


哑 | 





} 


Public static class MyLayoutParams extends MarginLayoutParams { 
public static int POSITION RIGHT = 1;// 右 边 
public static int POSITION BOTTOM = 2;// 底 部 


Public int position = -1;// 


Public MyLayoutParams (Context c, AttributeSet attrs) { 
super(c, attrs); 


TypedArray a=c.obtainStyledRttributes (attrs, R.styleable.CustomLayoutLP); 
position=a.getInt (R.styleable.CustomLayoutLP layout position, position); 
a.recycle(); 

上 


Public MyLayoutParams (int width，int height) { 
super (width, height); 
} 


Public MyLayoutParams (ViewGroup.LayoutParams source) { 
super (source); 
} 
} 


LayoutParams 重 写 完 了 ， 但 是 我 们 的 MyViewGroup 如 果 想 要 支持 android:layout_margin 属性 
以 及 自 定 义 属 性 ， 还 得 继续 修改 onMeasure 和 onLayout 方法 。 
onMeasure 方法 只 需要 修改 一 行 代码 ， 累 加 宽度 的 时 候 顺 便 加 上 左右 边 距 : 


MyLayoutParams lp= (MyLayoutParams) child.getLayoutParams () 
measuredWidth+=child.getMeasuredWidth()+lp.leftMargin+lp.rightMargin;// 加 上 
左右 边 距 


onLayout 方法 修改 代码 比较 多 ， 修 改 后 的 代码 如 下 : 
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QOverride 

Protected void onLayout (boolean changed, int 1, int t, int r, int b) { 
Log.i("ansen", "onLayout"); 
int count=getChildCount () ;// 获 取 子 View 数量 
int left=0; 


forl(int i=0;i<count;i++){ 
View child=getChildat (i); 


MyLayoutParams lp= (MyLayoutParams) child.getLayoutParams () 


int childwidth=child.getMeasuredWidth () ;// 获 取 子 View 宽度 
int childHeight=child.getMeasuredHeight () ;// 获 取 子 View 高 度 


if(lp.position==MyLayoutParams.POSITION RIGHT) { 
// 当 前 子 View 显示 在 ViewGroup 右边 
child.layout (getWidth()-childWidth,0,getWidth(),childHeight); 
// 设 置 摆 放 位 置 
}else if(1P.pPosition==MyLayoutParams .POSITION BOTTOM) { 
//// 当 前 子 View 显示 在 ViewGroup 底部 
child.layout (left+lp.leftMargin,getHeight ()-childHeight, left+ 
childWidth+lp.leftMargin,getHeight ()); 
}else{// 没 有 设置 位 置 的 View 
child.layout (left+lp.leftMargin,0,1left+childWidth+lp.leftMargin, 
child.getMeasuredHeight ()); 
} 


Log.i("ansen","left:"+left+" top:"+0+" right:"+(left+childWwidth)+" 
bottom:"+childHeight); 
left+=childWidth+lp.leftMargin+lp.rightMargin; 
日 
} 
(1) 我 们 先 看 position=-1 的 View， 也 就 是 else 里 面 的 代码 。 这 个 有 点 绕 ， 要 仔细 地 看 几 遍 ， 
最 好 自己 打印 log， 或 者 把 View 的 宽 高 在 纸 上 画 出 来 。Top 和 Bottom 跟 之 前 一 样 ， 下 面 我 们 来 看 
Left 和 Right。 
当 i=0 的 时 候 ，Left= 左 边 距 ，Right= 宽 度 + 左边 距 。 
当 计 1 的 时 候 ,Left= 上 一 个 View 到 ViewGroup 的 宽度 距离 + 上 一 个 View 的 右边 距 + 当前 View 
的 左边 距 ，Right= 上 一 个 View 到 ViewGroup 的 宽度 距离 + 上 一 个 View 的 右边 距 + 当 前 View 
的 宽度 + 当前 View 的 左边 距 。 


(2) 接 下 来 我 们 看 position 有 值 的 View， 只 要 理解 了 position=-1 的 情况 ，position=1 和 
position=2 里 面 的 代码 就 很 好 理解 了 。 
® ”position=] 时 , 当前 View 显示 在 ViewGroup 的 右边 ,需要 改变 onLayout 方 法 中 的 Left 和 Right 
参数 , 既然 是 显示 在 ViewGroup 的 右边 , Left 的 值 就 是 ViewGroup 的 宽度 -当前 View 的 宽度 ， 
Right 的 值 就 是 ViewGroup 的 宽度 。 
@ position=2 时 ， 当 前 View 显示 在 ViewGroup 的 底部 ， 需 要 改变 onLayout 方法 中 的 Top 和 
Bottom， 原 理 同上 .。 


66 | Android App 开发 从 入 门 到 精通 





最 后 重新 修改 activity_main.xml 文件 ， 给 控件 设置 外 间距 ， 让 第 一 个 TextView 显示 在 
最 后 一 个 TextView 显示 在 右边 。 运 行 代码 ， 效 果 如 图 2-8 所 示 。 


<com.ansen.views .MyViewGroup 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="wrap content" 
android:layout height="wrap content" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:background="@android:color/darker gray"> 











<TextView 
android:layout width="60dp" 
android:layout height="60dp" 
android:background="@android:color/holo red light" 
android:padding="10dp" 
android:layout marginLeft: 0dp" 
android:layout marginRight="10dp" 
app:layout position="bottom" 
android:text="1"/> 





<TextView 
android:layout width="60dp" 
android:layout height="80dp" 
android:layout marginLeft= 
android:layout marginRight="20dp" 
android:background="@android:color/holo blue light" 
android:padding="10dp" 
android:text="2" /> 





<TextView 

android:layout width="40dp" 

android:layout height="60dp" 

android:background="@android:color/holo orange light" 

android:padding="10dp" 

app:layout position="right" 

android:text="3" 

android:textColor="@android:color/white"/> 
</com.ansen.views.MyViewGroup> 


ViewGroup 








图 2-8 ViewGroup 重 写 generateLayoutParams 方法 


E 底 部 、 
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第 三 个 TextView 设置 了 right 但 是 却 看 不 出 效果 ， 需 要 修改 一 下 xml 文件 ， 把 MyViewGroup 
控件 的 android:layout_width 和 android:layout_height 改 成 match_parent， 再 次 运行 ， 效 果 如 图 2-9 
所 示 。 


ViewGroup 





2-9 ViewGroup 重 写 generateLayoutParams 方法 


2.3” 儿 种 常用 的 布局 


Android 中 系统 SDK 有 5 种 布局 , 所 有 的 布局 都 继承 自 ViewGroup, 分 别 是 LinearLayout ( 线 
性 布局 ) 、FrameLayout (框架 布局 ) 、AbsoluteLayout (绝对 布局 ) 、RelativeLayout (相对 布局 ) 、 
TableLayout〈 表 格 布局 ) 。 但 是 从 这 几 年 的 开发 经 验 来 看 ，AbsoluteLayonut 与 TableLayout 几乎 没 
有 用 到 ， 所 以 就 给 大 家 讲解 其 他 三 个 常用 布局 。 


2.3.1 LinearLayout (线性 布局 ) 


LinearLayout 是 线性 布局 控件 ， 是 ViewGroup 的 子 类 ， 会 按照 android: orientation 属性 的 值 对 
子 View 进行 排序 , 可 以 将 子 View 设置 为 垂直 或 水 平方 向 布局 。LinearLayonut 的 每 个 子 视图 都 会 按 
照 它 们 各 自在 XML 中 的 出 现 顺序 显示 在 屏幕 上 。 其 他 两 个 属性 android:layout_width 和 
android:layout_height 则 是 所 有 视图 的 必 备 属性 ， 用 于 指定 它们 的 尺寸 。 


1. 设置 排列 方式 


android:orientation="vertical" ; 垂直 排列 
android:orientation="horizontal"; 水 平 排列 


例如 ， 在 LinearLayout 布局 中 放 三 个 TextView 并 且 甜 直 显 示 ， 布 局 如 下 : 
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<?xml Version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 





<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 文 本 1"/> 





<TextView 

android:layout width="wrap content" 
:layout height="wrap content" 
layout marginTop="10dp" 
android:layout marginBottom="10dp" 
android:text=" 文 本 2"/> 





<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 文 本 3"/> 
</LinearLayout> 


垂直 显示 效果 如 图 2-10 所 示 ， 让 大 家 有 一 个 直观 感受 ， 





就 是 从 上 往 下 一 行 一 行 显示 。 





LinearLayout 





图 2-10 垂直 显示 


如 果 将 排列 方式 改 成 horizontal (水 平 ) ， 查 看 水 平 显示 效果 ， 可 以 看 到 依次 从 左 到 右 显示 ， 
如 图 2-11 所 示 。 


LinearLayout 





图 2-11 水 平 显示 


2.android:layout_gravity (对 齐 方式 ) 

layout_gravity 是 LinearLayout 子 元 素 的 特有 属性 。 对 于 layout_gravity， 该 属性 用 于 设置 控件 
相对 于 容器 的 对 齐 方式 , 可 选项 有 top、bottom、 left、 right、 center_vertical、 center_horizontal、 center、 
fill 等 。 

接着 上 面 的 布局 进行 修改 ， 给 LinearLayout 中 文本 2 设置 一 个 layout_gravity 属性 : 


第 2 章 Android 控件 


| 69 





android:layout gravity="center horizontal" 


其 效果 如 图 2-12 所 示 。 


LinearLayout 








图 2-12 文本 2 设置 layout gravity 属性 
从 效果 图 中 可 以 看 到 ， 显 示 文本 2 的 TextView 水 平 居中 了 。 
3. weight (权重 ) 


LinearLayout 布局 中 layout_weight 属性 用 来 分 配子 View 在 LinearLayout 中 占用 的 空间 (显示 
大 小 ) ， 只 有 LinearLayout 包 庄 的 View 才 有 这 个 属性 。 将 上 面 水 平 显示 的 布局 文件 修改 一 下 ， 其 


效果 如 图 2-13 所 示 。 


LinearLayout 





图 2-13 三 个 TextView 的 宽度 一 臻 


从 上 面 的 效果 图 可 以 看 出 三 个 TextView 的 宽度 是 一 致 的 。 我 们 来 看 看 源码 有 什么 变化 。 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="horizontal"> 


<TextView 
android:layout width="wrap content" 
android:1layout height="wrap content" 
android:background="@android:color/holo red light" 
android:layout weight="1" 
android:text=" 文 本 1"/> 








<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:background="@android:color/holo green light" 
android:layout weight="1" 
android:text=" 文 本 2"/> 





<TextView 
android:layout width="wrap content" 
android:layout height="wrap_content" 


70 | Android App 开发 从 入 门 到 精通 





android:background="@android:color/holo orange dark" 
android:layout weight="1" 
android:text=" 文 本 3"/> 
</LinearLayout> 
LinearLayout 的 宽度 匹配 父 类 ， 也 就 是 屏幕 的 宽度 ， 然 后 来 看 三 个 TextView 都 设置 了 
android:layout_weight="1"， 其 实 就 是 整个 屏幕 分 成 三 份 ， 显 示 三 个 文本 。 因 为 怕 大 家 不 好 区 分 ， 所 
以 顺便 给 TextView 加 上 了 背景 颜色 。 
在 学 习 过 程 中 大 家 也 可 以 自己 修改 android:layout_weight 的 值 ， 看 看 会 出 现 什么 效果 。 例 如 ， 
把 1:1:1 改 成 2:3:4， 当 android:layout_weight 的 值 改 成 2:3:4 时 , 通俗 点 解释 就 是 把 屏幕 的 宽度 分 成 
9 份 ， 第 一 个 TextView 的 宽度 是 2.9， 第 二 个 TextView 的 宽度 是 3/9， 第 三 个 TextView 的 宽度 是 
4/9。 


2.3.2 RelativeLayout (相对 布局 ) 


RelativeLayout 是 相对 布局 ， 控 件 的 位 置 是 按照 相对 位 置 来 计算 的 ， 一 个 控件 需要 依赖 另外 一 
个 控件 或 者 依赖 父 控 件 。 这 是 实际 布局 中 最 常用 的 布局 方式 之 一 。 它 灵活 性 大 很 多 , 当然 属性 也 多 ， 
操作 难度 也 大 。 

RelativeLayout 常用 的 一 些 属性 如 下 : 


第 一 类 : 属性 值 为 true 或 false 


android:layout centerHorizontal 相对 于 父 元 素 水 平 居 中 
android:layout centerVertical ”相对 于 父 元 素 垂 直 居 中 
android:layout centerInparent 相对 于 父 元 素 完全 居中 (水 平 垂 直 都 居中 ) 
android:layout alignParentBottom 贴 紧 父 元 素 的 下 边缘 
android:layout alignParentLeft 贴 紧 父 元 素 的 左边 缘 
android:layout alignParentRight 贴 紧 父 元 素 的 右边 缘 
android:layout_alignParentTop 贴 紧 父 元 素 的 上 边缘 


第 二 类 : 属性 值 必须 为 id 的 引用 名 "@+id/name" 


android:layout below 在 某 元 素 的 下 方 

android:layout above 在 某 元 素 的 上 方 

android:layout toLeftOf 在 某 元 素 的 左边 

android:layout toRightOf 在 某 元 素 的 右边 

android:layout alignTop 本 元 素 的 上 边缘 和 某 元 素 的 上 边缘 对 齐 
android:layout alignLeft 本 元 素 的 左边 缘 和 某 元 素 的 左边 缘 对 齐 
android:layout alignBottom 本 元 素 的 下 边缘 和 某 元 素 的 下 边缘 对 齐 
android:layout_alignRight 本 元 素 的 右边 缘 和 某 元 素 的 右边 缘 对 齐 


第 三 类 : 属性 值 为 具体 的 值 ， 如 30dp、40dp 

android:layout marginBottom 高 某 元 素 底 边 缘 的 距离 

android:layout marginLeft 高 某 元 素 左边 缘 的 距离 

android:layout marginRight 离 某 元 素 右 边缘 的 距离 

android:layout_marginTop 离 某 元 素 上 边缘 的 距离 

由 于 涉及 的 属性 比较 多 ， 就 不 一 一 详细 讲解 了 ， 用 RelativeLayout 布局 写 了 一 个 登录 界面 ， 大 
家 可 以 学 习 在 布局 中 如 何 运用 这 些 属 性 。 


<?xml Version="1.0" encoding="utf-8"?> 
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<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/tv nickname" 
android:layout marginTop="10dp" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:textSize="20sp" 
android:text=" 用 户 名 :" /> 


<EditText 
android:id="@+id/et nickname" 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:layout toRightOf="@+id/tv nickname" 
android:textSize="20sp" 


android:hint=" 请 输入 用 户 名 "” /> 


<TextView 
android:id="@+id/tv password" 
android:layout marginTop="20dp" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:layout below="@+id/tv nickname" 
android:layout alignBottom="@+id/et password" 
android:textSize="20sp" 
android:text=" 密 。 码 :" /> 


<EditText 
android:id="@+id/et password" 
android:layout marginTop="10dp" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout below="@+id/tv nickname" 
android:layout toRightOf="@+id/tv password" 
android:textSize="20sp" 


android:hint=" 请 输入 密码 ” /> 


<Button 

android:layout below="@+id/et password" 
style="@style/Widget.AppCompat .Button.Colored" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentRight="true" 
android:text=" 登 录 "/> 

</RelativeLayout> 


从 布局 中 可 以 看 到 , 通过 android:layout toRightO 仁 "@+id/tv_nickname" 属 性 把 输入 框 放 到 文本 
的 后 面 , 或 者 通过 android:layout below="@+id/tv_nickname" 属 性 把 密码 输入 框 放 到 用 户 名 的 下 面 。 
还 可 以 通过 android:layout marginTop 设置 上 面 的 外 边 距 ， 并 为 Button 设置 
android:layout_alignParentRight="true" 属 性 ， 就 是 放 在 父 布局 的 右边 。 最 后 效果 如 图 2-14 所 示 。 
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eA 11:15AM 


RelativeLayout 





用 户 名 :和 清 输入 用 户 名 





码 : 请 输入 密码 








2-14 ”RelativeLayout 效果 


2.3.3 ”FrameLayout (框架 布局 ) 


FrameLayout 是 Android 中 比较 简单 的 布局 之 一 ， 该 布局 
直接 在 屏幕 上 开辟 出 了 一 块 空白 区 域 。 向 其 中 添加 控件 时 ， 所 
有 的 组 件 都 会 置 于 这 块 区 域 的 左上 角 。 如 果 所 有 的 组 件 者 一 样 。 aha 
大 的 话 ， 同 一 时 刻 只 能 看 到 最 上 面 的 那个 组 件 。 当 然 ， 可 以 为 
组 件 添加 layout_gravity 属性 ， 从 而 指定 对 齐 方式 。 

写 一 个 简单 的 Demo， 效 果 如 图 2-15 所 示 。 

布局 文件 最 外 层 是 FrameLayout 布局 ， 第 一 个 控件 是 
TextView， 宽 高 都 是 220dp， 第 二 个 和 第 三 个 的 宽 高 依次 减少 ， 
可 以 看 到 第 三 个 会 覆盖 第 二 个 ， 第 二 个 会 覆盖 第 一 个 ， 第 四 个 
TextView 因为 设置 了 android:layout_gravity="center_horizontall 
bottom" 属 性 ， 所 以 相对 父 布局 水 平 居中 并 且 位 于 底部 。 

<?xml version="1.0" encoding="utf-8"?> 


<FrameLayout 
xmlns:android="http://schemas .android.com/apk/res 








/android" 国 | 
android:layout width="match parent" 
android:layout height="match Parent"> 图 2-15 ”FrameLayout 布局 效果 
<TextView 


android:layout width="220dp" 
android:layout height="220dp" 
android:background="@android:color/holo red light" /> 


<TextView 
android:layout width="180dp" 
android:layout height="180dp" 
android:background="@android:color/holo blue light" /> 


<TextView 
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android:layout width="120dp" 
android:layout height="120dp" 
android:background="@android:color/holo orange light"/> 


<TextView 
android:layout width="50dp" 
android:layout height="50dp" 
android:layout gravity="center horizontal|bottom" 
android:background="@android:color/link text holo dark"/> 
</FrameLayout> 


2.3.4 ”三 大 布局 嵌 套 以 及 动态 添加 View 


1. 多 层 赔 套 

当 布局 比较 复杂 时 ， 就 需要 多 层 嵌 套 来 解决 问题 了 ， 但 是 也 不 要 嵌 套 过 多 ， 要 灵活 运用 学 会 
的 这 几 种 布局 。 当 熟悉 之 后 看 到 一 个 Android 界面 ， 就 知道 哪里 应 该 用 什么 布局 。 多 层 嵌 套 所 有 的 
布局 都 支持 的 ，LinearLayout 嵌 套 FrameLayout，FrameLayout 也 可 以 网 套 LinearLayout， 这 里 就 用 
LinearLayout 实现 登录 界面 。 

先 看 效果 ， 如 图 2-16 所 示 。 


OA 12:16PM 


LayoutNesting 





图 2-16 幅 套 效果 


从 宏观 的 角度 来 看 ， 第 一 行 、 第 二 行 、 第 三 行 可 以 用 LinearLayout 的 垂直 排列 实现 ， 接 下 来 
细 分 到 每 一 行 ， 第 一 行 与 第 二 行 用 到 了 两 个 控件 ， 所 以 可 以 购 套 一 层 ， 然 后 设置 水 平 排列 方式 。 第 
三 行 是 一 个 按钮 ， 可 以 设置 android:layout_gravity="right" 属 性 。 


<?xml Version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="horizontal"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 用 户 名 :" 
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android:textSize="20sp" /> 


<EditText 
android:id="@+id/et nickname" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint=" 请 输入 用 户 名 " 
android:textSize="20sp" /> 
</LinearLayout> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="horizontal"> 





<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 密 。” 码 : 
android:textSize="20sp" /> 








<EditText 
android:id="@+id/et password" 
android:layout width="match parent" 
android:layout height="wrap content" 








android:hint=" 请 输入 密码 " 
android:textSize="20sp" /> 
</LinearLayout> 
<Button 


style="@style/Widget.AppCompat .Button.Colored" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="right" 
android:text=" 登 录 "/> 

</LinearLayout> 


2. 动态 添加 View 

有 时 布局 文件 的 View 数量 是 不 固定 的 ， 需 要 根据 逻辑 来 判断 要 添加 多 少 View。 这 种 情况 下 ， 
只 能 在 代码 中 来 添加 View 了 。 我 们 就 在 登录 的 代码 上 增加 。 

给 LinearLayout 设置 一 个 id， 这样 才 能 在 代码 中 查找 这 个 控件 。 

android:id="e+id/11_root_view" 


在 布局 中 增加 一 个 按钮 : 


<Button 
android:id="@+id/btn add view" 
style="@style/Widget.AppCompat .Button.Colored" 
android:layout width="wrap Content" 
android:layout height="wrap content" 
android:layout gravity="right" 
android:text=" 给 LinearLayout 动态 添加 View"/> 
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Activity 〈 活 动 页 面 ) 中 的 代码 比较 简单 ， 查 找 控件 ， 给 按钮 设置 点 击 事件 ， 在 点 击 回调 中 动 
态 添 加 View。 


public class MainActivity extends AppCompatActivity implements 
View.OnClickListenert{ 
Private LinearLayout llRootView; 
@Override 
Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main); 


// 通 过 id 查找 LinearLayout 

llRootView= (LinearLayout) findViewById(R.id.11 root view) 
// 给 按钮 设置 点 击 事件 

findViewById(R.id.btn add view) .setOnClickListener (this); 


1 


@Override 
public void onClick(View v) { 
TextView textView=new TextView (this); 
textView.setText ("动态 添加 View"); 
11RootView.addView (textView) ;// 通 过 addView 方法 动态 添加 控件 


} 
运行 修改 后 的 代码 ， 其 效果 如 图 2-17 所 示 。 


LayoutNesting 


用 户 名 : 情 输 入 用 户 名 





清 输 入 密码 





赎 态 添加 View 
态 添加 View 








2-17 动态 添加 View 


2.4 初级 控件 的 使 用 


本 节 将 学 习 Android 基础 控件 的 使 用 ， 了 解 常 用 属性 并 且 熟 练 运用 。 
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2.4.1 TextView (文本 视图 ) 


TextView 显示 一 行 或 者 多 行文 本 ， 也 能 显示 html。 在 Android 开发 中 ，TextView 是 最 常用 的 
组 件 之 一 ， 基 本 上 每 天 都 会 使 用 。 
1. 设置 背景 颜色 


<TextView 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:background="#FFOOFF™" 
android:layout marginTop="10dp" 
android:text=" 设 置 背景 颜色 "” /> 


2. 在 程序 中 动态 赋值 
这 里 既 可 以 直接 是 字符 串 ， 也 可 以 是 字符 串 资源 id。 


TextView tv0= (TextView) findViewById(R.id.tv0) 
tv0.setText ("如 何在 程序 里 面 动态 赋值 ") ; 


3. 实现 多 字符 串 的 动态 处 理 

(1 ) 在 strings.xml 文件 中 写 上 字符 串 

<string name="testing"> 这 是 一 个 数 : %1$q, 这 是 两 位 数 : $2$d, 这 是 三 位 数 : %3$s</string> 
(2) 在 Java 代码 中 设置 什 

tvl.setText (getString (R.string.testing, new Integer[]{11,21,31})); 

4. TextView 显示 html， 字 体 颜 色 为 红色 

需要 注意 的 是 ， 不 支持 html 标签 的 style 属性 。 


String html="<font color ='red'>TextView 显示 html 字体 颜色 为 红色 </font><br/>"; 
tv3.setText (Html .fromHtml (html)); 


5. 给 TextView 设置 点 击 事件 
这 个 事件 是 父 类 View 的 ， 所 以 所 有 的 Android 控件 都 有 这 个 事件 ， 这 里 为 了 方便 就 采用 了 内 
部 类 的 方式 。 


tv4 .setOnClickListener (new OnClickListener() { 
@Override 
Public void onClick(View v) { 
Toast .makeText (MainActivity.this, "点 击 了 TextView4", 
Toast .LENGTH LONG) .show(); 
} 
Ds; 


6. 给 TextView 文字 加 粗 并 设置 阴影 效果 
字体 阴影 需要 4 个 相关 参数 : 

@ android:shadowColor: 阴影 的 颜色 。 

@ android:shadowDx: 水 平方 向 上 的 偏 移 量 。 


第 2 章 Android 控件 


77 





@ android:shadowDy: 垂直 方向 上 的 偏 移 量 。 
@ android:shadowRadius: 阴影 的 半径 大 小 。 


<TextView 


android: 
android: 
android: 
android: 
android: 


android: 
android: 
android: 
android: 
android: 


id="@+id/tv5" 

layout width="wrap content" 
layout height="wrap content" 
layout marginTop="10dp" 
textStyle="bold" 


shadowColor="#ff000000" 
shadowDx="10" 
shadowDy="10" 
shadowRadius="1" 


text=" 文 字 阴影 ,文字 加 粗 ” /> 


7. TextView 显示 文字 加 图 片 
设置 图 片 相关 的 属性 主要 有 以 下 几 个 : 


drawableBottom: 在 文本 框 内 文本 的 底 端 绘制 指定 图 像 。 
drawableLeft: 在 文本 框 内 文本 的 左边 绘制 指定 图 像 。 


© 0 0 0 9。 


drawableRight: 


在 文本 框 内 文本 的 右边 绘制 指定 图 像 。 


drawableTop: 在 文本 框 内 文本 的 顶端 绘制 指定 图 像 。 
drawablePadding: 设置 文本 框 内 文本 与 图 像 之 间 的 间距 。 


以 下 代码 在 文字 左边 显示 一 张 图 片 ， 并 且 设 置 文 字 跟 图 片 之 间 的 间距 为 10dp。 


<TextView 


android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/tv6" 

layout width="wrap content" 

layout height="wrap content" 

layout marginTop="10dp" 
drawableLeft="@drawable/ic launcher" 
drawablePadding="10dp" 
gravity="center Vertical" 


text=" 文 字 + 图 片 ” /> 


8. TextView 的 样式 类 Span 的 使 用 
首先 新 建 一 个 SpannableString 对 象 ， 构 造 方法 中 传 入 要 显示 的 内 容 ， 调 用 SpannableString 的 
setSpan 方法 实现 字符 串 各 种 风格 的 显示 。setSpan 方法 有 四 个 参数 。 参 数 1 表示 格式 ， 可 以 是 前 景 
色 、 背 景色 等 ， 我 们 这 里 用 的 是 背景 色 。 参 数 2 设置 格式 的 开始 index。 参 数 3 结束 index。 参 数 4 


是 一 


人 


常量 ， 有 以 下 四 


个 值 : 


Spannable. SPAN_INCLUSIVE_EXCLUSIVE: 前 面包 括 ， 后 面 不 包括 ， 即 在 文本 前 插入 新 的 
文本 会 应 用 该 样式 ， 而 在 文本 后 插入 新 文本 不 会 应 用 该 样式 。 
Spannable. SPAN_INCLUSIVE_INCLUSIVE: 前 面包 括 ， 后 面包 括 ， 即 在 文本 前 插入 新 的 文 
本 会 应 用 该 样式 ， 而 在 文本 后 插入 新 文本 也 会 应 用 该 样式 。 


Spannable. SPAN_EXCLUSIVE_EXCLUSIVE: 前 面 不 包括 ， 后 面 不 包括 。 
Spannable. SPAN_EXCLUSIVE_INCLUSIVE: 前 面 不 包括 ， 后 面包 括 。 
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最 后 调用 TextView 的 setText 把 SpannableString 对 象 设置 进去 。 


SpannableString spannableString = new SpannableString ("TextView 的 样式 类 Span 
的 使 用 详解 ") ， 
BackgroundColorSpan backgroundColorSpan = new 
BackgroundColorSpan (Color .RED); 
//0 到 10 的 字符 设置 红色 背景 
spannableString.setSpan (backgroundColorSpan, 0, 10, Spannable. 
SPAN EXCLUSIVE EXCLUSIVE) ; 
tv7.setText (spannableString); 


9. TextView 设置 点 击 事件 Spannable 


除了 给 TextView 设置 背景 颜色 之 外 ， 还 可 以 给 TextView 中 某 一 段 文 字 设 置 点 击 效 果 ， 调 用 
SpannableString.setSpan 方法 时 第 一 次 参数 传 入 ClickableSpan 格式 。 使 用 ClickableSpan 时 ， 在 点 击 链 
接 时 凡是 有 要 执行 的 动作 ， 必 须要 给 TextView 设置 MovementMethod 对 象 。 


SpannableString spannableClickString = new SpannableString ("TextView 设置 点 击 
事件 span") ， 
ClickableSpan clickableSpan = new ClickableSpan() { 
override 
Public void onClick(View widget) { 
Toast .makeText (MainActivity.this,"TextView 设置 点 击 事件 Span"， 
Toast .LENGTH _ LONG) .show() 7 
spannableClickString.setSpan(clickableSpan,11,15, 
Spannable.SPAN EXCLUSIVE INCLUSIVE) ; 
tv8.setMovementMethod (LinkMovementMethod.getInstance()); 
tv8 .setText (spannableClickString); 


10. TextView 设置 点 击 背景 
步骤 014 新 建 一 个 selector_textview.xml 文件 ， 放 到 drawable 目录 下 。 


<?xml version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 


<item android:drawable="@color/textview click background" 
android:state focused="true"/> 

<item android:drawable="@color/textview click background" 
android:state pressed="true"/> 

<item android:drawable="@color/textview default"/> 


</selector> 


步 又 024 在 TextView 的 xml 布局 中 设置 背景 。 





android:background="@drawable/selector textview" 
步 又 034 设置 点 击 事件 。 


// 必 须要 给 TextView 加 上 点 击 事件 ， 点 击 之 后 才能 改变 背景 颜色 
findViewById(R.id.tv9) .setOnClickListener (new OnClickListener() { 
@Override 
Public void onClick(View v) { 


0 





第 2 章 Android 控 件 | 79 





Toast .makeText (MainActivity.this, "点 击 了 TextView9", 
Toast .LENGTH LONG) .show() 7 
} 
Ps 


11. 跑马 灯 效 果 
当 一 行文 本 的 内 容 太 多 ， 导 致 无 法 全 部 显示 ， 也 不 想 分 行 演示 时 ， 可 以 让 文本 从 左 到 右 滚动 
显示 ， 类 似 于 跑马 灯 。 
<!-- 跑马 灯 效 果 --> 


<TextView 
android:id="@+id/tv12" 
android:layout width="match Parent" 
android:layout height="wrap Content" 
android:layout margin="10dp" 
android:ellipsize="marquee" 
android:marqueeRepeatLimit="marquee forever" 
android:scrollHorizontally="true" 
android:focusable="true" 
android:focusableInTouchMode="true" 
android:singleLine="true" 
android:text=" 跑 马 灯 效 果 学 好 android 开发 就 关注 公众 号 android 开发 666 经 常 
推送 原创 文章 "/> 


最 后 效果 如 图 2-18 所 示 。 


DL 





ndroid 开 发 就 关注 公众 号 android 开 发 66 经 党 推送 原创 文章 





图 2-18 设置 文本 视图 


2.4.2 Button (按钮 ) 


Button 继承 自 TextView。 在 Android 开发 中 ，Button 是 常用 的 控件 ， 用 起 来 很 简单 ， 既 可 以 
写 在 xml 布局 文件 中 ,也 可 以 在 Java 代码 中 手动 创建 后 加 入 到 布局 管理 器 中 ,其 效果 都 是 一 样 的 。 
不 过 , 最 好 是 在 xml 文档 中 定义 ,因为 一 旦 要 改变 界面 的 话 ， 直 接 修改 xml 就 行 了 , 不 用 修改 Java 
程序 , 并 且 在 xml 中 定义 层次 分 明 , 一 目 了 然 。 Button 支持 的 XML 属性 及 相关 方法 如 表 2-2 所 示 。 
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表 2-2 Button 支持 的 XML 属性 及 相关 方法 




















XML 属性 相关 方法 说 明 

android:clickable setClickable(boolean clickable) 设置 是 否 允 许 点 击 
@ clickable=true: 允许 点 击 
@ clickable=false: 禁止 点 击 

android:background setBackgroundResource(int resid) 通过 资源 文件 设置 背景 色 resid: 资源 xml 
文件 ID 按钮 默认 背景 为 android.R.drawable. 
btn_default 

android:text setText(CharSequence text) 设置 文字 

android:textColor setTextColor(int color) 设置 文字 颜色 

android:onClick setOnClickListener(OnClickListener |) 设置 点 击 事件 





下 面 通 过 实例 来 给 大 家 介绍 Button 的 常用 效果 。 
首先 看 一 下 布局 文件 activity_main.xml。 


t= 





<?xml version="1.0" encodin 

<LinearLayout xmlns:android: 
android:layout width="match Parent" 
android:layout height="match parent" 
android:layout marginLeft="10dp" 
android:orientation="vertical"> 





<Button 
android:id="@+id/btn click one" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Button 点 击 事件 写法 1"” /> 





<Button 
android:id="@+id/btn click two" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:onClick="click" 
android:text="Button 点 击 事件 写法 2” /> 












<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginTop="10dp" 





"http://schemas.android.com/apk/res/android" 


android:background="@mipmap/icon button bg" 


android:padding="10dp" 
android:text="Button 设置 背景 图 片 ”/> 





<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginTop="10dp" 





android:background="@android:color/holo red dark" 


android:padding="10dp" 
android:text="Button 设置 背景 颜色 " /> 
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<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginTop="10dp" 
android:background="@drawable/shape button test" 
android:padding="1l0dp" 
android:text="Button 设置 shape" /> 


<TextView 
style="@style/Widget.AppCompat .Button.Colored" 
android:layout width="match parent" 
android:layout height="50dp" 
android:layout marginLeft="20dp" 
android:layout marginRight="20dp" 
android:layout marginTop="10dp" 
android:text="V7 包 按钮 样式 " 
android:textColor="#ffffffff" 
android:textSize="20sp" /> 


</LinearLayout> 


布局 文件 对 应 的 效果 如 图 2-19 所 示 。 


ButtonTest 
Button 点 击 事件 写法 1 


Button 点 击 事件 写法 2 


V7 包 按钮 样式 


图 2-19 布局 了 6 个 按钮 





上 面 布局 文件 中 定义 了 6 个 Button， 指 定 的 规则 如 下 。 
(1) 按钮 1: 给 Button 指定 了 android:id="@+id/btn_click_one"， 在 MainActivity.xml 根据 id 
进行 查找 并 且 设置 点 击 事件 。 
// 给 第 一 个 按钮 设置 点 击 事件 


findViewById(R.id.btn click _ one) .setOnClickListener (onClickListener) 7 





点 击 之 后 进行 Toast 提示 。 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
Public void onClick(View v){ 
Toast .makeText (MainActivity.this,"Button 点 击 事件 1"， 
Toast .LENGTH LONG) .show(); 
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人 


(2) 按钮 2: 给 xml 中 的 button 增加 了 android:onClick="click" 属 性 ， 然 后 在 该 布局 文件 对 应 
的 Acitivity 中 实现 该 方法 。 需 要 注意 的 是 ， 这 个 方法 必须 符合 三 个 条 件 : 

@ 方法 的 修饰 符 是 public。 

@ 返回 值 是 void 类 型 。 

@ 只 有 一 个 参数 View， 这 个 View 就 是 被 点 击 的 控件 。 

Public void click(View v){ 
Switch (v.getId()){ 
case R.id.btn click two: 
Toast .makeText (MainActivity.this,"Button 点 击 事件 2"， 


Toast .LENGTH LONG) .show() 7 
break; 





上 
(3) 按钮 3: 设置 一 张 背景 图 片 用 android:background 属性 。 


android:background="@mipmap/icon button bg" 


(4) 按钮 4: 设置 背景 颜色 用 android:background 属性 。 


android:background="@android:color/holo red dark" 


(5) 按钮 5: 设置 背景 shape，android:background="@drawable/shape_button_test"， 可 以 自 定 
义 Button 的 外 观 ， 从 效果 图 中 可 以 看 到 Button 背景 透明 、 有 边框 、 有 弧度 。shape_button_test.xml 
文件 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" > 
<!-- 默认 背景 色 --> 
<solid android:color="@android:color/transparent"/> 
<!-- 边框 --> 
<stroke 
android:width="1ldp" 
android:color="@android:color/black" /> 


<!-- 设置 弧度 --> 
<corners 
android:radius="20dp"/> 
</shape> 


(6) 按钮 6: 设置 按钮 的 样式 。 
style="@style/Widget .AppCompat .Button.Colored" 
这 是 V7 包 中 自 带 的 Style 样式 。 按 钮 的 颜色 是 ButtonTest/app/src/main/res/values/colors.xml 下 
name="colorAccent" 的 颜色 。 
Button 使 用 注意 事项 : 


(1)Button 的 setOnClickListener 优先 级 比 xml 中 android:onClick 高 , 如 果 同 时 设置 点 击 事件 ， 
只 有 setOnClickListener 才 有 效 。 
(2) 能 用 TextView 就 尽量 不 要 用 Button，TextView 灵活 性 更 高 。 
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2.4.3 EditText〈 文 本 编辑 框 ) 


EditText 在 开发 中 是 经 常用 到 的 控件 ， 也 是 一 个 比较 重要 的 组 件 ， 可 以 说 它 是 用 户 与 Android 
应 用 进行 数据 传输 的 窗户 ， 比 如 实现 一 个 登录 界面 ， 需 要 用 户 输入 账号 和 密码 ， 然 后 获取 用 户 输入 


内 容 ， 提 交 给 服务 器 进行 判断 。EditText 支持 的 XML 属性 及 相关 方法 如 表 2-3 所 示 。 


表 2-3 EditText 支持 的 XML 属性 及 相关 方法 











android:drawableLeft 


XML 属性 相关 方法 说 明 
android:text setText(CharSequence text) 设置 文本 内 容 
android:textColor setTextColor(int color) 字体 颜色 
android:hint setHint(int resid) 内 容 为 空 时 显示 的 文本 
android:textColorHint void setHintTextColor(int color) 为 空 时 显示 的 文本 颜色 
android:inputType setInputType(int type) 限制 输入 类 型 
@ number: 整数 类 型 
e@ numberDecimal: 小 数 点 类 型 
e@ date: 日 期 类 型 
e text: 文本 类 型 (默认 值 ) 
e@ phone: 拨号 键盘 
@ textPassword: 密码 
@ textVisiblePassword: 可 见 密码 
@ textUri: 网 址 
android:maxLength 限制 显示 的 文本 长 度 ， 超 出 部 分 不 显示 
android:minLines setMaxLines(int maxlines) 设置 文本 的 最 小 行 数 
android:gravity setGravity(int gravity) 设置 文本 位 置 ， 如 设置 成 “center”， 文 本 将 
居中 显示 


setCompoundDrawables(Drawable 在 text 的 左边 输出 一 个 drawable， 如 图 片 
lefDrawable top,Drawable right, 
Drawable bottom) 





android:drawablePadding 


设置 text 与 drawable (图片 ) 的 间隔 ， 与 
drawableLeft、drawableRight、drawableTop、 
drawableBottom 一 起 使 用 ， 可 设置 为 负数 ， 
单独 使 用 没有 效果 





android:digits 
android:ellipsize 


设置 允许 输入 哪些 字符 ， 如 “1234567890” 

设置 当 文 字 过 长 时 该 控件 该 如 何 显示 

e@ start: 省 略 号 显示 在 开头 

e end: 省 略 号 显示 在 结尾 

e@ middle: 省 略 号 显示 在 中 间 

e@ marquee: 以 跑马 灯 的 方式 显示 (动画 横 
向 移动 ) 





android:lines 








setLines(int lines) 设置 文本 的 行 数 ， 设 置 两 行 就 显示 两 行 ， 即 
使 第 二 行 没 有 数据 
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( 续 表 ) 





XML 属性 


相关 方法 


说 明 





android:lineSpacingExtra 





android:singleLine setSingleLine0) 


设置 行 间距 
tmue: 单行 显示 
false: 可 以 多 行 








android:textStyle | 





设置 字形 ， 可 以 设置 一 个 或 多 个 ， 用 "\ 





1. EditText 实现 登录 界面 
首先 查看 布局 文件 activity_main.xml。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:1layout width="match parent" 


android:1layout heigh 





"match parent" 


android:orientation="vertical"> 


<EditText 












android:id="@+id/et phone" 
android:layout width="match parent" 
layout height="wrap content" 
:layout marginLeft="20dp" 
android:layout marginRight="20dp" 








android:maxLength 
android:hint=" 请 输入 手机 号 " 
id:drawablePadding="10dp" 
:padding="10dp" 


:drawableLeft="@mipmap/icon phone" 


android:drawableBottom="@drawable/shape et bottom line" 


android:layout marginTop="20dp"/> 


<EditText 


android:id="@+id/et password" 
androi ayout width="match parent" 





android:layout height="wrap Content" 


android:layout marginLeft="20dp" 
android:layout marginRight="20dp" 
android:layout marginTop="10dp" 
android:background="@null" 
android:inputTyp textPassword" 
android:maxLengt 和 
android:padding="10dp" 
android:drawablePadding="10dp" 
android:hint=" 请 输入 密码 " 








android:drawableBottom="@drawable/shape et bottom line" 
android:drawableLeft="@mipmap/icon password"/> 


<TextView 


android:id="@+id/tv login™ 


style="@style/Widget.AppCompat .Button.Colored" 


android:layout width="match parent" 
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android:layout height="50dp" 
android:layout marginLeft="10dp" 
android:layout marginRight="10dp" 
android:layout marginTop="30dp" 
android:text=" 登 录 " 
android:textColor="#ffffffff" 
android:textSize="18sp"” /> 
</LinearLayout> 


运行 效果 如 图 2-20 所 示 。 





EditTextDemo 


请 输入 手机 号 


| 请 输入 密码 





图 2-20 EditText 实现 登录 界面 


这 两 个 输入 框 用 的 大 部 分 属性 都 在 上 面 的 表格 中 ， 这 里 介绍 一 下 没有 提 到 的 属性 。 

android:background="@null" 表 示 和 输入 框 无 背景 。android:drawableBottom="@drawable/shape_et_ 
bottom_line" 表 示 底 部 引入 一 个 shape 布局 文件 ， 这 个 布局 文件 就 是 输入 框 的 下 划 线 。 
shape_et_bottom_line.xml 内 容 如 下 : 





<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle" > 


<solid android:color="#1E7EE3" /> 
<size android:height="ldp" android:width="500dp"/> 


</shape> 

2. EditText 监听 输入 内 容 

当 使 用 Google 或 者 百度 进行 网 页 搜索 时 ， 只 要 我 们 在 输入 框 中 输入 内 容 ， 就 会 对 关键 词 进行 
联想 匹配 , 实现 的 原理 很 简单 ,就 是 监听 输入 框 内 容 的 变化 , 把 内 容 上 传 给 服务 器 进行 关键 词 查 询 ， 
然后 客户 端 把 结果 展示 出 来 。 

下 面 的 代码 实现 了 监听 EditText 内 容 的 变化 ， 首 先 通过 id 找到 EditText 控件 ， 调 用 EditText 
控件 的 addTextChangedListener 添加 文本 改变 监听 , 这 里 我 们 用 内 部 类 方式 实现 TextWatcher 接口 ， 
外 写 TextWatcher 接口 的 三 个 方法 (beforeTextChanged、onTextChanged、afterTextChanged) 。 可 
以 在 onTextChanged 方法 中 把 用 户 输入 的 结果 上 传 给 服务 器 。 


EditText etOne= (EditText) findViewById(R.id.et phone); 
etOne.addTextChangedListener (new TextWatcher() { 
@Override 











86 | Android App 开发 从 入 门 到 精通 





public void beforeTextChanged (CharSequence s，int start, int count, 
int after) { 
Log .i ("Ansen", "内 容 改 变 之 前 调用 : "+s); 


QOverride 
public void onTextChanged (CharSequence s, int start, int before, int 
count) { 
Log.i ("Ansen", "内 容 改变 ， 可 以 去 告诉 服务 器 : "+s); 


@Override 
public void afterTextChanged (Editable s) { 
Log.i ("Ansen", "内 容 改 变 之 后 调用 : "+s); 
’ 
I 


2.4.4 ”ImageView (图 像 视图 ) 


ImageView 用 于 显示 图 片 的 View， 是 开发 中 频繁 使 用 的 一 个 控件 ， 毕 竞 现在 4G 网 络 普及 了 ， 
手机 加 载 一 张 图 片 很 快 ， 所 以 很 多 App 都 使 用 了 大 量 的 图 片 。 

只 需 在 xml 文件 加 入 ImageView， 就 能 够 显示 图 片 : 

<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match Parent" 
android:layout height="match Parent"> 


<ImageView 
android:id="@+id/iv one" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:src="@mipmap/ic launcher"/> 


</RelativeLayout> 


这 里 给 ImageView 设置 了 src 属性 ， 引 用 的 图 片 在 mipmap 文件 夹 中 ， 是 用 Android Studio 创 
建 一 个 项 目 时 自 带 的 图 片 。 在 真实 的 企业 开发 中 ,一 般 会 替换 掉 这 个 图 片 的 内 容 ， 因 为 这 张 图 片 的 
名 字 一 般 用 作 程 序 的 启动 图 标 。 程 序 运行 效果 如 图 2-21 所 示 。 


ImageView 


器 





图 2-21 添加 图 片 
接 下 来 ， 给 ImageView 设置 点 击 事件 ， 点 击 图 片 之 后 通过 代码 动态 改变 显示 的 图 片 。 


Public class MainActivity extends AppCompatActivity { 
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Private ImageView imageView7 


GOverride 

protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main) 7 


imageView= (ImageView) findViewById(R.id.iv one);// 通 过 id 查找 到 图 片 控件 
imageView.setOnClickListener (onClickListener);// 设 置 点 击 监听 事件 
} 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
imageView.setImageResource (R.mipmap .coffee) ;// 改 变 显示 的 图 片 
} 
]7 


在 onCreate 方法 中 ， 首 先 通过 id 查找 xml 中 的 图 片 控件 ， 然 后 设置 点 击 事件 ， 点 击 之 后 修改 
显示 的 图 片 ， 其 运行 结果 如 图 2-22 所 示 。 


ImageView 





图 2-22 点击 后 显示 新 图 片 
可 以 看 到 点 击 之 后 图 片 改 变 了 ， 这 张 咖啡 的 图 片 是 事先 复制 到 res/mipmap-hdpi 文件 夹 中 的 。 


2.4.5 ”RadioButton 〈 单 选 按钮 ) 


RadioButton 在 Android 开发 中 也 是 比较 常见 的 控件 ， 从 多 个 选项 中 选择 一 项 时 会 用 到 。 实 
现 单 选 按钮 需要 将 RadioButton 和 RadioGroup 配合 使 用 。 

RadioGroup 是 单 选 组 合 框 《 相 当 于 容器 ) ， 用 于 将 RadioButton 框 起 来 ， 在 没有 RadioGroup 
的 情况 下 ,RadioButton 可 以 全 部 选中 ; 当 多 个 RadioButton 被 RadioGroup 包含 的 情况 下 ,RadioButton 
只 可 以 选择 一 个 。 

开发 中 比较 常见 的 就 是 App 注册 界面 需要 选择 性 别 ， 一 般 都 会 有 两 个 选项 : 男 / 女 。 

首先 查看 布局 文件 ， 就 是 外 层 一 个 RadioGroup， 其 中 包含 两 个 RadioButton 。 
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<?xml Version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:1ayout width="match parent" 
android:layout height="match parent"> 


<RadioGroup 
android:id="@+id/radiogroup" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:orientation="horizontal"> 





<RadioButton 
android:id="@+id/rb male" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 男 "/> 


<RadioButton 
android:id="@+id/rb girl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 女 "/> 
</RadioGroup> 
</RelativeLayout> 


布局 文件 只 能 展示 UI 效果， 但 是 我 们 的 程序 肯定 要 增加 交互 性 ,需要 把 用 户 选 中 的 结果 记录 
下 来 ， 所 以 还 得 在 活动 页 面 中 监听 RadioGroup 的 选中 事件 。 


Public class MainActivity extends AppCompatActivity { 
@Override 
Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 


RadioGroup radioGroup= (RadioGroup) findViewById(R.id.radiogroup); 
radioGroup.setOnCheckedChangeListener (onCheckedChangeListener); 
» 


Private OnCheckedChangeListener onCheckedChangeListener=new 
OnCheckedChangeListener() { 
@Override 
Public void onCheckedChanged (RadioGroup group, int checkedId) { 
if(checkedId==R.id.rb male){ 
Toast .makeText (MainActivity.this, "您 的 性 别 是 男 "， 
Toast .LENGTH SHORT) .show(); 
}else if(checkedId==R.id.rb girl){ 
Toast .makeText (MainActivity.this, "您 的 性 别 是 女 "， 
Toast .LENGTH SHORT) .show(); 
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在 onCreate 方法 中 通过 id 获取 到 RadioGroup 对 象 ， 然后 将 其 设置 为 选中 改变 监听 器 , 在 监听 


器 的 回调 方法 中 通过 checkedId 来 判断 选中 了 哪个 选项 。 接 下 来 
通过 Toast 进行 显示 。 

给 大 家 补充 一 个 新 的 知识 点 : Toast 是 Android 中 用 来 显示 
信息 的 一 种 机 制 ， 与 Dialog 不 一 样 的 是 ，Toast 没有 焦点 ， 而 且 
Toast 显示 的 时 间 有 限 , 会 根据 用 户 设置 的 显示 时 间 后 自动 消失 ， 
主要 用 于 向 用 户 显 示 提 示 信 息 。 

运行 程序 ， 点 击 性 别 “ 男 ”， 其 效果 如 图 2-23 所 示 。 











2.4.6 Checkbox〔 复 选 框 ) 


CheckBox 与 RadioButton 一 样 ， 只 有 两 种 状态 ， 即 选中 与 
未 选中 , 两 者 的 区 别 就 是 CheckBox 可 以 实现 多 选 。 例如， 做 一 
个 在 线 考试 系统 ， 选 择 题 有 单 选 题 和 多 选 题 ， 单 选 题 可 以 用 
RadioButton 实现 ， 多 选 题 可 以 用 CheckBox 实现 。 

上 一 节 已 经 学 习 了 RadioButton， 接 下 来 学 习 CheckBox， 
首先 查看 xml 布局 文件 : 


<?xml version="1.0" encoding="utf-8"?> 


RadioButton 


图 2-23 单 选 按钮 显示 效果 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match Parent" 
android:layout height="match Parent" 
android:orientation="vertical"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 你 会 几 种 编程 语言 ?” /> 


<TextView 
android:id="@+id/tv result" 
android:layout margin="10dp" 
android:layout width: rap content" 
android:layout height="wrap content" 
android:textSize="18sp" 








android:textColor="@android:color/holo blue light"/> 


<CheckBox 
android:id="@+id/cb java" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Java"/> 


<CheckBox 
android:id="@+id/cb php" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Php"/> 
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<CheckBox 
android:id="@+id/cb c" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="C"/> 
</LinearLayout> 


前 面 用 到 了 两 个 TextView: 第 一 个 用 来 显示 提问 的 文字 ， 第 二 个 用 来 展示 选中 之 后 的 结果 。 
后 面 是 三 个 复 选 框 ， 代 表 三 个 选项 。 
按照 前 面 的 例子 ， 大 家 应 该 明白 了 xml 只 有 UI 效果 ， 所 有 的 逻辑 需要 在 活动 页 面 中 处 理 。 


public class MainActivity extends AppCompatActivity { 
private TextView tvResult;// 用 来 显示 结果 





Private String javaResult="",phpResult="",cResult=""; 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity main); 


tvResult= (TextView) findViewById(R.id.tv result); 


// 查 找 控件 并 且 设 置 选中 改变 监听 
CheckBox cbJava= (CheckBox) findViewById(R.id.cb java); 
CheckBox cbPhp= (CheckBox) findViewById(R.id.cb php); 
CheckBox cbC= (CheckBox) findViewById(R.id.cb c); 
cbJava.setOnCheckedChangeListener (onCheckedChangeListener); 
cbPhp . setOnCheckedChangeListener (onCheckedChangeListener); 
cbC.setOnCheckedChangeListener (onCheckedChangeListener) 

} 


Private CompoundButton.OnCheckedChangeListener 
onCheckedChangeListener=new CompoundButton.OnCheckedChangeListener() { 
@Override 
Public void onCheckedChanged (CompoundButton buttonView, boolean 
isChecked){ 
if(buttonView.getId() .id.cb java) {// 通 过 id 区 分 不 同 的 复 选 框 
// 如 果 选 中 了 Java 就 把 "Java" 赋 值 给 javaResult， 否 则 "" 赋 值 给 javaResul 
// 这 里 用 到 了 三 元 表达 式 ， 如 果 不 会 请 先 去 学 习 java 基础 
javaResult=isChecked?"Java":""; 
}else if(buttonView.getId()==R.id.cb php){ 
PhpResult=isChecked?"Php":""; 
}else if(buttonView.getId()==R.id.cb c){ 
CResult=isChecked?"C":""; 





// 展 示 选 中 结果 


tvResult.setText (javaResult+" "+phpResult+" "+cResult); 


首先 在 onCreate 中 查找 控件 , 并 设置 选中 改变 监听 , 在 监听 函数 中 根据 id 区 分 不 同 的 复 选 框 ， 
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然后 根据 是 否 选中 来 赋值 ， 最 后 把 结果 给 TextView 显示 在 屏幕 上 。 运行 之 后 ,选中 了 Java 和 C 复 
选 框 ， 效 果 如 图 2-24 所 示 。 


Checkbox 





2-24 ” 复 选 框 显示 效果 


2.4.7 ”ProgressBar (进度 条 ) 


ProgressBar 在 Android 中 比较 常用 。ProgressBar 分 为 确定 的 和 不 确定 的 两 种 ， 确 定 的 是 能 明 
确 看 到 进度 ， 不 确定 的 就 是 不 清楚 、 不 确定 一 个 操作 需要 多 长 时 间 来 完成 。 
本 例 用 了 水 平 进度 条 和 圆 形 进度 条 ， 水 平 进度 条 是 确定 进度 的 ， 圆 形 进度 条 表示 不 确定 进度 。 
同时 在 两 个 进度 条 的 上 方 放 上 两 个 按钮 ， 用 来 操作 水 平 进度 条 的 进度 值 。 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 


android:layout height="match parent" 
android:orientation="vertical"> 





<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="horizontal"> 
<Button 
android:id="@+id/btn add" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 进 度 值 +"/> 


<Button 
android:id="@+id/btn reduce" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 进 度 值 -"/> 
</LinearLayout> 


<ProgressBar 
android:id="@+id/pb horizontal" 
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style="?android:attr/progressBarStyleHorizontal" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:max="100" 

android:progress="0"/> 








<ProgressBar 
android:id="@+id/pb large" 
style="?android:attr/progressBarStyleLarge" 
android:layout width="match parent" 
android:layout height="wrap content"/> 
</LinearLayout> 


这 种 多 辑 代 码 与 之 前 的 差不多 ， 相 信 大 家 很 熟悉 了 ， 就 是 查找 控件 。 接 下 来 给 两 个 按钮 设置 
点 击 事件 ， 在 点 击 回调 方法 中 修改 水 平 进度 条 的 值 。 


public class MainActivity extends AppCompatActivity { 
private ProgressBar pbHorizontal; 












@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main) 7 


PbHorizontal= (ProgressBar) findViewById(R.id.pb _ horizontal)， 


findViewById(R.id.btn_add) .setOnClickListener(onClickListener) 
findViewById(R.id.btn reduce) .setOnClickListener (onClickListener); 
} 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
switch (v.getId()){ 
case R.id.btn add: 
PbHorizontal .setProgress (pbHorizontal .getProgress()+10); 
break; 
case R.id.btn reduce: 
PbHorizontal.setProgress (pbHorizontal .getProgress ()-10) 
break; 


在 真实 的 企业 开发 中 ， 一 般 用 确定 进度 条 表示 下 载 文件 进度 ， 用 不 明确 的 进度 条 表示 正在 访 
问 网 络 。 这 里 只 是 为 了 演示 ProgressBar 用 法 ， 所 以 就 用 两 个 按钮 的 点 击 来 修改 进度 条 的 值 。 最 后 
运行 效果 如 图 2-25 所 示 。 
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二 DPE ESD 
ProgressBar 


进度 值 + 进度 值 - 


2-25 ”两 种 不 同 的 进度 条 


2.4.8 ”ProgressDialog (进度 对 话 框 ) 


ProgressDialog 经 常用 于 一 些 费 时 的 操作 ， 需 要 用 户 进行 等 待 。 例 如 ， 加 载 网 页 内 容 ， 这 时 需 
要 一 个 提示 来 告诉 用 户 程序 正在 运行 ， 并 没有 假死 或 者 真 死 ， 而 ProgressDialog 就 是 专门 干 这 项 工 
作 的 。 
- 般 使 用 它 的 步骤 为 : 在 执行 耗 时 间 的 操作 之 前 弹出 ProgressDialog 提示 用 户 ， 然 后 开 一 个 新 
线程 。 在 新 线程 中 执行 耗 时 的 操作 ， 运 行 完毕 之 后 通知 主 程序 将 ProgressDialog 结束 。 
新 建 项 目 ， 首 先 修改 activity_main.xml 文件 ， 增 加 一 个 按钮 ， 布 局 文件 比较 简单 ， 就 不 贴 出 来 
了 ， 直 接 看 MainActivity 如 何 实现 : 


Public class MainActivity extends AppCompatActivity { 
private ProgressDialog staticDialog; 


@Override 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
SetContentView(R.layout .activity main); 


// 创 建 对 象 ， 调 用 Dialog 的 show 方法 显示 
//ProgressDialog dialog = new ProgressDialog (this); 
//dialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL) ;// 水 平 
//dialog.incrementProgressBy (20);// 设 置 进度 值 
//dialog.setCanceledonTouchOutside (false); 

// 设置 在 点 击 Dialog 外 是 否 取 消 Dialog 进度 条 
// dialog.show();// 显 示 


// 调用 ProgressDialog 的 静态 方法 显示 5 秒 后 关闭 。 模 拟 访问 网 络 过程 
findViewById(R.id.btn show) .setOnClickListener (new 
View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
staticDialog = ProgressDialog.show (MainActivity.this," 这 是 标题 
"vv "这 是 内 容 ") ; 
/* 开启 一 个 新 线程 ， 在 新 线程 里 执行 耗 时 的 方法 */ 
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new Thread (new Runnable () { 
@Override 
public void run() { 
try { 
Thread.sleep(5000);// 延 迟 5 秒 
} catch (InterruptedException e) { 
e.printStackTrace (); 
} 
handler .sendEmptyMessage (0) ;// 延 迟 5 秒 之 后 发 送 消息 给 handler 
} 


}) .start() 7 


]) 7 


Handler handler = new Handler() { 
@Override 
public void handleMessage (Message msg) {//handler 接收 到 消息 后 就 会 执行 此 方法 
staticDialog.dismiss();// 关闭 ProgressDialog 
] 7 


调用 ProgressDialog 的 静态 方法 显示 ， 开 启 一 个 新 的 线程 ， 延 迟 5 秒 ， 然 后 给 handler 发 送 一 
个 消息 ， 在 handler 的 handleMessage 方法 中 关闭 ProgressDialog。 程 序 运行 结果 如 图 2-26 所 示 。 


3 





图 2-26 显示 进度 对 话 框 


2.4.9 ”AlertDialog (简单 对 话 框 ) 


在 Android 开发 中 , 经 常 需要 在 Android 界面 上 弹出 一 些 对 话 框 ,例如 询问 用 户 或 者 让 用 户 选 
择 《〈 如 删除 提示 对 话 框 、 警 告 对 话 框 等 ) ， 这 些 功 能 用 AlertDialog 对 话 框 来 实现 。 
Public class MainActivity extends AppCompatActivity { 
@Override 


Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
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setContentView(R.layout.activity main) 


findViewById(R.id.btn show dialog) .setOnClickListener (new View. 
OnClickListener() { 
@Override 
public void onClick(View v) { 
showDialog(); 
]) 7 
} 


// 显 示 对 话 框 

protected void showDialog() { 
AlertDialog.Builder builder = new AlertDialog.Builder (this); 
builder.setTitle ("提示 ") ; // 设 置 标题 
builder .setMessage ("确认 退出 吗 ?") ;// 设 置 消 息 
builder.setIcon(R.mipmap.ic launcher);// 设 置 icon 
builder .setPositiveButton ("确认 ", new DialogInterface.OnClickListener (){ 


QOverride 
public void onClick(DialogInterface dialog, int which) { 
dialog.dismiss(); 
MainActivity.this.finish();// 结 束 当前 Activity 
} 
yn 
builgder.setNegativeButton ("取消 ", new DialogInterface.OnClickListener(){ 


QOverride 
Public void onClick(DialogInterface dialog, int which) { 
dialog.dismiss(); 
} 
BY 
builder.create() .show(); 


} 


点 击 按钮 ， 弹 出 一 个 对 话 框 ， 给 对 话 框 设 置 了 标题 、 内 容 、 图 片 、 两 个 按钮 监听 事件 。 这 段 
代码 相信 大 家 很 好 理解 ， 运 行 效 果 图 如 图 2-27 所 示 。 





提示 


确认 退出 吗 ? 


图 2-27 弹出 简单 对 话 框 


96 | Android App 开发 从 入 门 到 精通 





2.4.10 “PopupWindow (弹出 式 窗口 ) 


PopupWindow 弹出 一 个 浮动 的 窗口 ， 可 以 显示 在 屏幕 任意 的 位 置 ， 比 Dialog 对 话 框 更 加 灵活 
(默认 只 能 在 屏幕 的 中 间 ) 。 我 们 还 可 以 通过 setAnimationStyle 方法 设置 PopupWindow 的 显示 或 
隐藏 动画 。 
本 例 中 ，PopupWindow 显示 在 某 个 控件 之 下 。 在 activity_main.xml 中 放置 两 个 按钮 ， 从 上 向 
下 显示 。 
<?xml Version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 


android:layout height="match parent" 
android:orientation="vertical"> 


<Button 
android:id="@+id/btn show popupwindow" 
android:layout width="wrap content" 
android:layout height="wrap content" 


android:text=" 在 当前 位 置 下 面 弹 出 PopupWindow" /> 








id="@+id/btn bottom popupwindow" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 从 底部 弹出 PopupWindow" /> 
</LinearLayout> 


在 活动 页 面 中 根据 id 查找 第 一 个 按钮 并 且 设 置 点 击 事件 : 


btnShowPopupwindow = (Button) findViewById(R.id.btn show popupwindow); 
btnShowPopupwindow.setOnClickListener (this); 


在 点 击 事件 中 调用 showAsDropDown 方法 : 


@Override 
Public void onClick(View v) { 
if(v.getId()==R.id.btn show popupwindow) {// 点 击 第 一 个 按钮 
showAsDropDown (); 








} 


接 下 来 ， 通 过 showAsDropDown 方法 显示 PopupWindow: 


Private void showAsDropDown(){ 

View popView = 

LayoutIinflater .from(this).inflate(R.layout.popup drop down,null); 
// 设 置 PopupWindow View, 宽度 ， 高 度 
PopupWindow popupWindow=new PopupWindow (popView, 
LinearLayout .LayoutParams .WRAP CONTENT, 

LinearLayout .LayoutParams .WRAP CONTENT); 
// 设 置 允 许 在 外 点 击 消失 , 必须 要 给 popupWinqdow 设置 背景 才 会 有 效 
PopupWindow.setOutsideTouchable (true) 
PopupWindow.setBackgroundDrawable (new BitmapDrawable()) 
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// 显 示 在 btnShowPopupwindow 按钮 下 面 ，x 位 置 偏 移 100px 就 是 偏 移 屏幕 左边 100px 
popupWindow.showAsDropDown (btnShowPopupwindow, 100,0); 
} 


PopupWindow 加 载 的 布局 文件 popup_drop_down.xml 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:background="@color/colorAccent"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:padding="10dp" 
android:text=" 我 是 点 击 上 面 那个 按钮 弹出 的 哦 " /> 


</LinearLayout> 


运行 以 上 代码 ， 其 效果 如 图 2-28 所 示 。 


可 


PopupWindow 


在 当前 位 置 下 面 弹出 PopupWindow 


| 


图 2-28 弹出 式 窗口 





接 下 来 的 实例 将 PopupWindow 显示 在 指定 位 置 ， 从 下 往 上 弹出 。 

我 们 给 第 二 个 按钮 设置 点 击 事件 ， 调 用 showBottomPopupwindow 方法 显示 PopupWindow。 设 
置 一 个 动画 效果 ， 从 下 往 上 弹出 。 

private void showBottomPopupwindow(){ 


View popView = 
LayoutInflater.from(this) .inflate (R.layout.popup bottom,null); 





final PopupWindow popupWindow=new PopupWindow (popView, 
LinearLayout .LayoutParams .MATCH PARENT, 

LinearLayout .LayoutParams .WRAP CONTENT); 
popupWindow.setOutsideTouchable (true) ;// 设置 允许 在 外 点 击 消失 
popupWindow. setBackgroundDrawable (new ColorDrawable (0x30000000) ) ;// 设 置 背 

景 颜色 
popupWindow.setAnimationSstyle (R.style.Animation Bottom Dialog) ;// 设 置 动画 
View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
if(v.getId()==R.id.btn camera album){ 
Toast .makeText (MainActivity.this, "点击 拍 照 按钮 "， 
Toast .LENGTH SHORT) .show(); 
}else if(v.getId()==R.id.btn camera cancel){ 
Toast .makeText (MainActivity.this," 点 击 了 取消 按钮 "， 
Toast .LENGTH SHORT) .show(); 





98 


Android App 开发 从 入 门 到 精通 





popupWindow.dismiss(); 

} 

Tn 

popView.findViewById(R.id.btn camera album) .setOnClickListener 
(onClickListener); 

popView.findViewById(R.id.btn camera cancel) .setOnClickListener 
(onClickListener); 

// 参 数 1: 根 视图 ， 整 个 window 界面 的 最 项 层 View ”参数 2 : 显示 位 置 

popupWindow .showAtLocation (getWindow() .getDecorView () ,Gravity.BOTTOM,0,0) ; 


底部 PopupWidnow 显示 的 布局 文件 popup_bottom.xml 如 下 : 


<?xml Version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="wrap_content" 
android:padding="10dp" 
android:orientation="vertical"> 


<Button 
android:id="@+id/btn camera album" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@color/colorAccent" 
android:text=" 拍 照 " 
android:textSize="18spP"” /> 


<Button 
android:id="@+id/btn camera cancel" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginTop="10dp" 
android:background="@color/colorPrimaryDark" 
android:text=" 取 消 " 
android:textSize="1l8sp" /> 


</LinearLayout> 


在 上 面 的 方法 中 ， 还 通过 setAnimationStyle 方法 设置 了 动画 ， 这 是 因为 在 style.xml 中 增加 了 
-个 style, android:windowEnterAnimation 是 PopupWindow 显示 动画 , android:windowExitAnimation 
是 PopupWindow 消失 动画 。 


<style name="Animation Bottom Dialog"> 


<item name="android:windowEnterAnimation">@anim/bottom dialog enter</item> 
<itemname="android:windowExitAnimation">@anim/bottom dialog exit</item> 


</style> 


在 上 面 的 style 中 引用 了 res/anim 下 的 两 个 动画 文件 。 


【bottom_dialog_enterxml】 


<?xml Version="1.0" encoding="utf-8"?> 


<translate xmlns:android="http://schemas.android.com/apk/res/android" 


android:duration="225" 
android:fromYDelta="100%" 
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android:interpolator="@android:anim/decelerate interpolator" 
android:toYDelta="0%"/> 


解释 上 面 这 个 xml 中 各 个 属性 的 作用 。 首 先 说 明 这 是 一 个 位 置 转移 动画 。 

android:duration: 动画 的 运行 时 间 ， 毫 秒 为 单位 。 

android:fromYDelta: 动画 起 始 时 ，Y 坐标 上 的 位 置 。 

android:toYDelta: 动画 结束 时 ，Y 坐标 上 的 位 置 。 

android:interpolator: 用 来 修饰 动画 效果 ,定义 动画 的 变化 率 ， 可 以 使 动画 效果 accelerated (加 
速 )、decelerated (减速 )、repeated (重复 )、bounced (弹跳 ) 等 。 


bottom_dialog_exit.xml 中 用 的 属性 与 上 面 的 一 样 ， 就 不 解释 了 。 


<?xml version="1.0" encoding="utf-8"?> 

<translate xmlns:android="http://schemas.android.com/apk/res/android" 
android:duration="225" 
android:fromYDelta="0%" 
android:interpolator="@android:anim/accelerate interpolator" 
android:toYDelta="100%"/> 


运行 效果 如 图 2-29 所 示 ， 显 示 与 隐藏 的 动画 效果 无 法 截图 , 大 
家 自己 运行 源 代码 。 


PopupWindow 
在 当前 位 下面 引出 popupwindow 


从 诺 部 弹 bPopupWndow 


2.4.11 DialogFragment 


DialogFragment 是 在 Android 3.0 版 本 中 被 引入 的 ,是 一 种 基于 
Fragment 的 Dialog， 可 以 用 来 创建 基本 对 话 框 、 警 告 对 话 框 ， 以 替 
代 Dialog。 
实现 DialogFragment， 需 要 重 写 DialogFragment 并 且 实 现 
onCreateView (LayoutInflater、ViewGroup、Bundle) 方法 获取 对 话 
框 显示 内 容 ， 或 者 重 写 onCreateDialog (Bundle) 来 创建 一 个 完全 自 
定义 的 对 话 框 。 
使 用 DialogFragment 的 好 处 如 下 : 
@ 因为 继承 自 Fragment， 所 以 具有 Fragment 的 所 有 特性 ， 可 以 图 2-29 弹出 式 窗口 
更 好 地 管理 生命 周期 ， 手 机 配置 发 生变 化 时 ， 我 们 能 够 进行 
监听 。 

@ ”在 活动 页 面 中 启动 对 话 框 ， 要 写 一 大 堆 逻 辑 代 码 、 监 听 等 ， 但 是 通过 DialogFragment 控制 对 
话 框 ， 通 过 调用 API 来 实现 何 时 显示 、 隐 藏 、 销 毁 ， 就 能 够 很 方便 地 管理 对 话 框 。 


实例 : 重 写 onCreateView 方法 ， 加 载 布局 文件 
继承 DialogFragment， 重 写 onCreateView 方法 : 





public class MyDialogFragment extends DialogFragment { 
static MyDialogFragment newInstance() { 
return new MyDialogFragment (); 
} 
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QOverride 
Public View onCreateView (LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View v = inflater.inflate(R.layout.hello world, container, false); 
TextView tv = (TextView) v.findViewById(R.id.textview); 
tv.setText ("This is an instance of MyDialogFragment"); 
return v; 


3 
在 onCreateView 方法 中 加 载 一 个 布局 文件 hello_world.xml， 布 局 文件 内 容 比 较 简单 ， 最 外 层 
是 FrameLayout， 里 面 是 一 个 TextView: 


<?xml version="]1.0" encoding="utf-8"?> 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 





:id="@+id/textview" 

:layout width="match parent" 

:layout height="match parent" 
android:gravity="center" 
android:text="Hello World" 
android:textSize="20sp"/> 

</FrameLayout> 


这 样 就 封装 了 一 个 DialogFragment 对 话 框 ,我 们 需要 在 哪个 activity 中 使 用 就 调用 它 显 示 一 下 ， 
一 行 代码 即 可 轻松 搞定 。 


MyDialogFragment .newInstance () .show (getSupportFragmentManager (), "MyDialogF 
ragment"); 


运行 代码 ， 效 果 如 图 2-30 所 示 。 














2-30 ”DialogFragment 对 话 框 
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实例 : 重 写 onCreateView 方法 ， 显 示 AlertDialog 对 话 框 

从 如 下 代码 中 看 到 ， 在 onCreateDialog 方法 中 创建 了 一 个 AlertDialog 对 象 返 回 ， 为 对 话 框 的 
两 个 按钮 设置 点 击 事件 。 

因为 要 处 理 按钮 的 点 击 事件 ， 所 以 增加 了 setOnClickListener 方法 ， 调 用 时 可 以 注入 对 话 框 两 个 
i 事件 监听 的 实现 。 


Public class MyAlertDialogFragment extends DialogFragment{ 
private DialogInterface.OnClickListener onClickListener; 

















public static MyAlertDialogFragment newInstance() { 
return new MyAlertDialogFragment (); 
y 


@Override 
public Dialog onCreateDialog (Bundle savedInstanceState) { 
AlertDialog.Builder builder=new AlertDialog.Builder (getActivity()) 
.SetIcon (R.mipmap.ic launcher) 
.SetTitle(R.string.app name) 7 


if (onClickListener!=nul1) {// 设 置 对 话 框 okgg 取 消 按钮 的 点 击 事件 
builder.setPositiveButton(R.string.alert dialog ok,onClickListener); 


builder.setNegativeButton (R.string.alert dialog cancel,onClickListener); 
上 
return builder.create () 7 


Public void setOnClickListener (DialogInterface.OnClickListener 
onClickListener) { 
this.onClickListener = onClickListener; 
} 
} 


通过 以 上 代码 ， 我 们 可 以 看 到 设置 
接 下 来 我 们 看 如 何在 Activity 中 调用 ， 代 码 不 多 ， 几 行 而 已 。 


MyAlertDialogFragment 
myAlertDialogFragment=MyAlertDialogFragment .newInstance(); 
myAlertDialogFragment .setOnClickListener (onClickListener); 
myAlertDialogFragment .show (getSupportFragmentManager (), "MyAlertDialogFragm 
ent™ js 


点 击 对 话 框 按钮 时 回调 监听 实现 : 


private DialogInterface.OnClickListener onClickListener=new 
DialogInterface.OnClickListener() { 
@Override 
Public void onClick(DialogInterface dialog, int which) { 
Switch (which){ 
case DialogInterface.BUTTON POSITIVE://ok 
Log.i("ansen", "ok"); 
break; 
case DialogInterface.BUTTON NEGATIVE://cancel 
Log.i("ansen","cancel"); 





监听 就 封装 在 自 定义 的 DialogFragment 中 。 


了 
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break; 


} 
] 


运行 效果 如 图 2-31 所 示 。 


DialogFragment 


2-31 ”DialogFragment 对 话 框 





2.5 ”Android 高 级 控件 的 使 用 


2.5.1 ListView“〔〈 列 表 视 图 ) 


在 Android 开发 中 ，ListView 是 很 常用 的 控件 ， 以 列表 的 形式 展示 具体 内 容 ， 并 且 能 够 根据 数 
据 的 长 度 自 适应 显示 。 

列表 的 显示 需要 三 个 元 素 : 

@ ListVeiw: 用 来 展示 列表 的 View。 

@ 适配器 : 用 来 把 数据 映射 到 ListView 上 的 中 介 。 

@ ”数据 源 : ListVeiw 中 的 每 一 行 View 对 应 数据 源 的 一 条 数据 。 


1. 简单 使 用 
首先 查看 布局 文件 ， 比 较 简 单 。 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 
<ListView 
android:id="@+id/listview" 
android:layout width="match parent" 
android:layout height="wrap content"/> 
</RelativeLayout> 
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接 下 来 查看 代码 ， 先 初始 化 数据 ， 循 环 20 条 数据 放 到 一 个 集合 中 ， 这 个 items 集合 就 是 数据 
， 然 后 通过 id 获取 ListView 对 象 ， 给 ListView 设置 一 个 适配器 。 
public class MainActivity extends AppCompatActivity { 
private ListView listView; 


private ListViewAdapter adapter; 
private List<String> items; 





@Override 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


initData(); 


listView= (ListView) findViewById(R.id.listview); 
listView.setAdapter (adapter=new ListViewAdapter (this,items)); 
} 


// 初 始 化 数据 
private void initData(){ 
items=new ArrayList<>(); 
for (int i=0;i<20;i++){ 
items.add("item:"+(i+1)); 


} 
自己 写 一 个 ListViewAdapter 类 ， 继 承 BaseAdapter， 然 后 





写 4 个 方法 。 


public class ListViewAdapter extends BaseAdapter{ 
Private List<String> data; 
Private LayoutInflater inflater; 


Public ListViewAdapter (Context context,List<String> data){ 
inflater=LayoutInflater.from(context); 
this.data=data; 

3 


// 数 据 源 长 度 

@Override 

Public int getCount() { 
return data.size(); 

让 


// 每 一 行 的 绑 定 数据 源 

QOverride 

public Object getItem(int position) { 
return data.get (position); 

上 


Override 
Public long getItemId (int Position) { 
return position; 


遇 
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// 获 取 每 一 行 的 View 
GOverride 
Public View getView(int position, View convertView, ViewGroup Parent) { 
ViewHolder viewHolder; 
if(convertView==nul1) 1{ 
viewHolder=new ViewHolder() 
//xml 文件 加 载 成 View 
convertView = inflater.inflate(android.R.layout.simple 
list item 1, parent, false); 
ViewHolder.text1= (TextView) convertView.findViewById 
(android.R.id.text1); 


convertView.setTag (viewHolder); 
}else{ 
ViewHolder= (ViewHolder) convertView.getTag(); 


viewHolder .text]1 .setText (data.get (position)); 
return convertView; 


} 


Private class ViewHolderi 
Private TextView textl; 

} 

对 于 上 面 的 代码 ， 详 细 解释 一 下 ，ListView 在 开始 绘制 时 ， 系 ” 及 于 
统 首先 调用 getCount0 函 数 ， 根 据 它 的 返回 值得 到 listView 的 长 度 ， 四 下 
然后 根据 这 个 长 度 , 调用 getView0 逐 一 绘制 每 一 行 。 如 果 getCount() 
返回 值 是 0， 列表 将 不 显示 ， 如 果 返 回 值 是 1， 就 仅 显示 一 行 。 

这 个 适配器 的 写法 是 目前 为 止 比较 标准 的 固定 写法 ，getView 
方法 中 用 到 了 ViewHolder 类 ， 这 是 因为 ListView 有 RecycleBin 机 
制 ， 列 表 滚 动 时 复 用 ItemView， 这 样 做 的 好 处 就 是 ， 不 管 列表 滑动 
了 几 千 条 还 是 上 万 条 的 数据 ，ListView 滚动 的 过 程 中 永远 只 会 创建 

- 屏 的 View。 如 图 2-32 所 示 ， 整 个 屏幕 显示 12 条 View， 说 明 这 
个 列表 就 算 一 直 往 下 滚动 ， 也 永远 只 会 创建 12 个 View。 

2. 每 一 行 点 击 监听 

不 需要 给 ListView 每 一 行 的 View 设置 点 击 事件 ，ListView 源码 
已 经 封装 了 setOnItemClickListener 方法 。 下 面 代 码 设置 了 ListView 
行 点 击 事件 ， 点 击 之 后 显示 一 个 Toast。 








图 2-32 列表 视图 
listView.setOnItemClickListener (new AdapterView. OnItemClickListener(){ 
@Override 
Public void onItemClick (AdapterView<?> parent, View view, int position, long 


ad) UL 
Toast .makeText (MainActivity.this, "点击 Item 位置 :"+position, 
Toast .LENGTH SHORT) .show(); 
} 
DD); 
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3. 设置 分 隔 线 
ListView 的 每 一 行 可 以 通过 分 隔 线 来 区 分 ， 只 需要 在 布局 中 为 ListView 增加 两 个 属性 即 可 。 


android:divider="@android:color/holo red light" // 分 隔 线 颜色 
android:dividerHeight="5dp" // 分 隔 线 高 度 


添加 了 分 隔 线 之 后 ， 运 行 效果 如 图 2-33 所 示 。 


ListView 








图 2-33 ”添加 分 隔 线 后 的 列表 
如 果 不 想 要 分 隔 线 ， 可 以 设置 分 隔 线 为 空 ， 或 者 将 分 隔 线 颜 色 设 为 透明 : 


android:divider="@null" 或 者 android:divider="@android:color/transparent" 


4. 添加 header 和 footer 


用 LayoutImnflater 类 的 from 静态 方法 获取 一 个 LayoutInflater 对 象 ， 调 用 inflate 方法 将 布局 文 
件 转化 成 View， 给 View 设置 一 个 点 击 监听 ， 调 用 ListView 的 addHeaderView 方法 把 头 布 局 添加 
进去 。 

View header=LayoutInflater.from(this) . 

inflate(R.layout.activity listview header,null); 


header.setOonClickListener (onClickListener) ;// 给 头 布局 设置 一 个 点 击 事件 
listView.addHeaderView (header) ;// 添 加 头 部 View 


View footer=LayoutInflater.from(this) . 
inflate(R.layout.activity listview footer,null); 


footer.setOnClickListener (onClickListener) ;// 给 头 布局 设置 一 个 点 击 事件 
listView.addFooterView (footer) ;// 添 加 尾部 View 


activity_listview_header.xml 文件 比较 简单 ， 就 放置 一 个 TextView。 (activity_listview_footer 
代码 与 此 几乎 一 样 ， 就 不 贴 出 来 了 ， 只 是 布局 的 id 不 一 样 而 已 ， 用 来 判断 点 击 事件 。) 


<?xrml version="1.0" encoding="utf-8"?> 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="et+id/11 header" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="vertical"> 


<TextView 

android:id="@+id/textView" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center horizontal" 
android:paddingTop="10dp" 
android:paddingBottom="10dp" 
android:text=" 这 是 ListView 头 部 布局 " 
android:background="@android:color/holo orange light"/> 

</LinearLayout> 


在 头 View 点 击 监听 函数 中 就 显示 了 一 个 Toast， 大 家 对 这 样 的 代码 应 该 很 熟悉 了 。 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.1l1 header: 
Toast .makeText (MainActivity.this, "点击 ListView 头 布 局 "， 
Toast .LENGTH SHORT) .show(); 
break; 





] 7 
5. 动态 修改 iem 


动态 改变 ListView 很 简单 ， 只 需要 修改 数据 源 ， 然 后 调用 adapter 的 notifyDataSetChanged 方 
法 更 新 适配器 即 可 ， 其 他 的 底层 已 经 封装 好 了 。 用 代码 来 举 个 例子 : 点 击 尾部 View 为 ListView 添 
加 一 行 数据 。 
Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.11 footer:// 点 击 底部 
items .add ("点 击 底部 添加 的 item") ; 
adapter.notifyDataSetChanged(); 
break; 


] 7 

在 底部 点 击 监听 方法 中 ， 给 数据 源 (也 就 是 集合 ) 添加 一 个 字符 串 ， 然 后 刷新 适配器 ， 两 行 
代码 就 能 为 ListView 增加 一 行 数据 。 如 果 想 删除 一 行 也 是 一 样 的 ， 删 除 源 数据 ， 然 后 更 新 适配器 。 
有 兴趣 的 读者 可 以 花 点 时 间 自 己 去 实现 。 
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6. 设置 显示 位 置 

listView.setSelection (items.size()-1); // 显 示 列表 最 后 一 条 

运行 结果 如 图 2-34 所 示 。 

7. 实现 聊天 界面 

一 般 情况 下 使 用 的 ListView 中 每 一 行 的 View 都 是 固定 的 ,但 是 一 些 特 殊 界面 会 有 多 个 布局 类 


型 ,例如 微 信 、 陌 陌 、QQ 等 聊天 App, 在 聊天 详情 界面 就 有 发 送 与 接收 两 个 布局 , 其 效果 如 图 2-35 
所 示 。 


ListView 


Htem:13 ListViewChat 


hem14 


为 什么 程序 员 到 哪里 都 背 着 电脑 包 


因为 他 们 没有 别 的 包 包 。 


程序 员 最 烦 两 件 事 ， 第 一 件 事 是 别人 
要 他 给 自 Ee ， 第 二 件 


Htem-16 
hem17 


Memn18 


是 别人 的 程序 没有 留 下 文档 。 


如 何 生成 一 个 随机 的 字符 趾 ? 





点 击 底部 源 加 的 item 

点 击 帮 部 沽 加 的 tem 让 新 手 退 出 VIM 
敲 才 之 后 可 以 柱 LietView 漠 加 一 行 

图 2-34 ”ListView 设置 显示 位 置 图 2-35 “聊天 界面 


想 要 实现 图 2-35 中 的 效果 ， 需 要 给 Adapter 加 载 不 同 的 item 布局 ， 重 写 Adapter 的 
getViewTypeCount 和 getItemViewType 方法 。 


//item 类 型 数量 

Q@Override 

public int getViewTypeCount() { 
return TYPE ACCEPT+1; 

} 


// 每 个 类 型 对 应 的 int 类 型 的 值 必须 从 0 开始 
Q@Override 
public int getItemViewType (int position) { 
if(messages.get (Position) .isSended()){ 
return TYPE SEND;// 发 送 类 型 
} 
return TYPE ACCEPT;// 接 收 类 型 
} 


为 每 种 类 型 定义 一 个 常量 ， 写 在 ListViewAdapter 类 中 。 


private final int TYPE_SEND=0;// 消 息 发 送 
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private final int TYPE_ACCEPT=1;// 消 息 接收 


当前 ， 在 getView 中 也 需要 处 理 一 下 ， 根 据 不 同 的 类 型 加 载 不 同 的 布局 文件 。 


Q@Override 

Public View getView(int position, View convertView, ViewGroup parent) { 
int type = getItemViewType (position); 
Message message=messages.get (position); 


ViewHolder viewHolder; 
if(convertView==null){ 
ViewHolder=new ViewHolder (); 
if (type==TYPE SEND) {// 发 送 的 消息 
convertView = inflater.inflate(R.layout.item message chat send, 
null); 
}else if (type==TYPE ACCEPT) {// 接 收 
convertView = inflater.inflate(R.layout.item message chat accept, 
null); 
} 


ViewHolder.tvContent= (TextView) 
convertView.findViewById(R.id.tv content); 
convertView.setTag (viewHolder); 
}else{ 
viewHolder= (ViewHolder) convertView.getTag(); 


BE 


viewHolder.tvContent.setText (message.getContent ()); 
return convertView; 


} 
发 送 布局 文件 与 接收 布局 文件 类 似 ， 这 里 贴 出 一 个 发 送 的 布局 ， 其 中 的 内 容 比较 简单 ， 仅 
个 TextView 和 ImageView， 即 内 容 与 头像 。 不 过 ， 控 件 的 属性 用 得 比较 多 。 


<?xml] version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="wrap content" 

android:layout height="wrap content" 

android:paddingBottom="7dip" 

android:paddingTop="7dip"> 





<TextView 
android:id="@+id/tv content" 
android:layout width="wrap content" 
android:layout height="wrap_content" 
android:layout marginLeft="55dp" 
android:layout toLeftOf="@+id/iv message from head image" 
android:background="@mipmap/icon message from" 
android:gravity="center" 
android:paddingRight="20dip" 
android:text=" 我 已 经 吃 过 了 " 
android:textColor="@color/white normal" 
android:textSize="16dip" /> 


<!-- --> 
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<ImageView 
android:id="@+id/iv message from head image" 
android:layout width="40dp" 
android:layout height="40dp" 
android:layout alignParentRight="true" 
android:layout marginLeft="5dp" 
android:layout marginRight="5dp" 
android:src="@mipmap/slide left avatar default" /> 
</RelativeLayout> 


如 果 仔细 阅读 了 前 面 的 内 容 ， 就 会 发 现 每 一 行 绑 定 的 数据 源 不 是 String 类 型 ， 而 是 Message 
类 型 了 。 
public class Message { 


private String content;// 消息 内 容 
private boolean sended;// 是 否 发 送 


Public Message () 1{ 
} 


Public Message (String content,boolean sended){ 
this .content=content7 
this.sended=sended; 


} 


public String getContent() { 
return content; 


} 


public void setContent (String content) { 
this.content = content; 
E 


Public boolean isSended() { 
return sended; 
} 


Public void setSended(boolean sended) { 
this.sended = sended; 
1 
} 
如 果 学 会 了 以 上 内 容 ，ListView 的 基本 使 用 就 没 问 题 了 。 这 里 在 代码 中 加 了 注释 ， 并 在 代码 
后 面 做 了 详细 的 解释 ， 希 望 能 够 帮助 大 家 更 好 地 理解 。 


2.5.2 ” GridView《〔〈 网 格 视图 ) 


GridView 是 按照 行列 的 方式 来 显示 内 容 的 ， 一 般 用 于 显示 图 片 列表 ， 比 如 九宫 格 列表 ， 使 用 
GridView 实现 起 来 很 简单 。GridView 的 用 法 与 ListView 类 似 , 首先 看 图 2-36， 效 果 图 中 显示 的 两 
张 图 片 是 网 上 找 的 。 
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图 2-36 ”网 格 视 图 


新 建 项 目 ， 首 先 修改 布局 文件 activity_main.xml。 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 
<GridView 
android:id="@+id/gridview" 
:numColumns="4" 
:scrollbars="none" 
:layout marginBottom="10dp" 
android:verticalSpacing="10dp" 
android:horizontalSpacing="10dp" 
android:layout width="match parent" 
android:layout height="wrap content"/> 







</RelativeLayout> 

GridView 控件 中 的 几 个 属性 作用 如 下 : 

® android:numColumns="4": 一 行 显示 4 列 。 

® android:scrollbars="none": 去 掉 滚 动 条 。 

® android:verticalSpacing="10dp": 两 行 之 间 的 间距 。 

® android:horizontalSpacing="10dp": 两 列 之 间 的 间距 。 





Activity 的 代码 比较 简单 ， 初 始 化 数据 、 设 置 适 配器 、 设 置 点 击 事件 。 


public class MainActivity extends AppCompatActivity { 
Private GridView gridview; 
Private List<Integer> images; 
Private GridAdapter gridAdapter; 
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@Override 

Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 


initData(); 
gridview= (GridView) findViewById(R.id.gridview); 
gridview.setAdapter (gridAdapter=new GridAdapter (this, images)); 


//item 设置 点 击 事件 


gridview.setOnItemClickListener (onItemClickListener); 


} 


private AdapterView.OnItemClickListener onItemClickListener=new 
AdapterView.OnItemClickListener() { 
@Override 
public void onItemClick (AdapterView<?> parent, View view, int position, 
long id) { 
Toast .makeText (MainActivity.this," 当 前 选中 了 " + 
":"+position,Toast.LENGTH SHORT) .show(); 


3 
// 初 始 化 数据 源 


Private void initData(){ 
images=new ArrayList<>(); 
for (int i=0;i<100;i++){ 
if(ig2==1){// 对 2 取 余 数 ， 结 果 为 1 
images .add (R.mipmap .test one) 7 
}else{ 
images .add (R.mipmap .test two); 





} 


} 
GridView 适配器 与 ListView 适配器 类 似 ，GridAdapterjava 代码 如 下 : 《因为 类 似 所 以 代码 不 
做 详细 解释 ) 


Public class GridAdapter extends BaseAdaptert{ 
Private LayoutIinflater inflater; 
Private List<Integer> images; 


Public GridAdapter (Context context,List<Integer> images){ 
inflater=LayoutInflater.from(context); 
this.images=images; 

} 


@Override 
Public int getCount() { 
return images.size()7 


QOverride 


112 | Android App 开发 从 入 门 到 精通 





Public Object getItem(int Position) { 
return images .get (Position) 7 
} 


@Override 

public long getItemId(int position) { 
return position; 

h 


@Override 
Public View getView(int position, View convertView, ViewGroup parent) { 
ViewHolder viewHolder; 
ifE(convertView==nul1) { 
viewHolder=new ViewHolder() 7 
convertView = inflater.inflate(R.layout .activity grid item, parent, 
false); 
ViewHolder.imageview = (ImageView) convertView.findViewById 
(R.id.imageview); 
convertView.setTag (viewHolder); 
}else{ 
viewHolder= (ViewHolder) convertView.getTag(); 


} 


viewHolder .imageview.setImageResource (images.get (position)); 
return convertView; 


} 


Private class ViewHolderi 
Private ImageView imageview; 
} 


item 的 布局 文件 : activity_grid_item.xml。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<ImageView 
android:id="@+id/imageview" 
android:layout gravity="center horizontal" 
android:layout width="match parent" 
android:layout height="70dp" 
android:scaleType="centerCrop" 
android:src="@mipmap/test one" /> 
</LinearLayout> 


android:scaleType="centerCrop” 均 衡 地 缩放 图 像 (保持 图 像 原始 比例 ) ， 使 图 片 的 宽 高 都 大 于 
等 于 View 宽 高 。 就 本 例 而 言 ，ImageView 的 高 度 是 70dp， 宽度 是 包 里 内容 ( 随 内 容 多 少 而 改变 ) ， 
设置 了 这 个 属性 之 后 ， 图 片 会 按照 比例 缩放 到 宽 高 都 是 70dp 为 止 。 
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2.5.3 ”RecyclerView (循环 视图 ) 


RecylerView 是 support-v7 包 中 的 新 组 件 ， 是 一 个 强大 的 滑动 组 件 ， 与 经 典 的 ListView 相 比 ， 
同样 拥有 item 回收 复 用 的 功能 ， 这 一 点 从 它 的 名 字 RecylerView (循环 视图 ) 也 可 以 看 出 。 官 方 对 
于 它 的 介绍 是 : RecyclerView 是 ListView 的 升级 版 本 ， 更 加 先进 和 灵活 。RecyclerView 通过 设置 
LayoutManager、ItemDecoration、ItemAnimator 可 实现 更 多 效果 。 

@ 使 用 LayoutManager 来 确定 每 一 个 item 的 排列 方式 。 

@ 使 用 ItemDecoration 自己 绘制 分 隔 线 ， 更 加 灵活 。 

@ 使 用 ItemAnimator 为 增加 或 删除 一 行 设置 动画 效果 。 





新 建 完 项 目 ， 需 要 在 app/build.gradle 增加 RecylerView 依赖 ， 不 然 找 不 到 RecyclerView 类 : 


compile 'com.android.support:recyclerview-v7:23.1.0' 





1. RecylerView 简单 的 Demo 
我 们 来 看 Activity 代码 ， 与 ListView 写法 其 实 差不多 ， 这 里 只 是 多 设置 了 一 个 布局 管理 器 。 


Public class LinearLayoutActivity extends AppCompatActivity { 
private RecyclerView recyclerView; 
Private RecyclerViewAdapter adapter; 
Private List<String> datas; 





@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.recycler main); 


initData(); 


recyclerView= (RecyclerView) findViewById(R.id.recyclerview); 
recyclerView.setLayoutManager (new LinearLayoutManager (this)); 
// 设 置 布局 管理 器 
recyclerView.addIitemDecoration (new DividerItemDecoration (this)); 
recyclerView.setAdapter (adapter=new 
RecyclerViewAdapter (this,datas)); 
} 


Private void initData(){ 
datas=new ArrayList<>(); 
Eor (int i=0;i<100;i++){ 

datas.add("item:"+i) 7 


} 


Activity 对 应 的 布局 文件 : recycler main.xml。 因 为 RecyclerView 是 v7 包 才 有 的 控件 ， 所 以 需 
要 在 布局 文件 中 指定 包 名 + 类 名 。 
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<?xml Version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/recyclerview" 
android:layout width="match Parent" 
android:layout height="match parent"/> 
</RelativeLayout> 


Adapter 相对 ListView 的 Adapter 来 说 变化 比较 大 。RecyclerViewAdapter.java 代码 如 下 : 


public class RecyclerViewAdapter extends 


RecyclerView.Adapter<RecyclerViewAdapter.MyViewHolder>{ 


int 


private List<String> datas; 
Private LayoutInflater inflater; 


public RecyclerViewRdapter (Context context,List<String> datas){ 
inflater=LayoutInflater.from(context); 
this.datas=datas; 

} 


// 创 建 每 一 行 的 View 用 RecyclerView.ViewHolder 包装 
@Override 
Public RecyclerViewAdapter .MyViewHolder onCreateViewHolder (ViewGroup parent, 
viewType) { 
View itemView=inflater.inflate(R.layout.recycler item,null); 
return new MyViewHolder (itemView); 
} 


// 给 每 一 行 View 填充 数据 
@Override 
Public void onBindViewHolder (RecyclerViewAdapter.MyViewHolder holder, int 


position) { 


holder.textview.setText (datas .get (position)); 
} 


// 数 据 源 的 数量 

@Override 

public int getItemCount() { 
return datas.size(); 

} 


class MyViewHolder extends RecyclerView.ViewHolder{ 
Private TextView textview; 


Public MyViewHolder (View itemView) { 
Super (ItemView) 7 
textview= (TextView) itemView.findViewById(R.id.textview) 


} 
时 


从 上 面 的 代码 中 看 到 需要 继承 RecyclerView.Adapter， 重 写 三 个 方法 (onCreateViewHolder、 
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onBindViewHolder、getItemCount) ， 同 时 MyViewHolder 也 需要 继承 RecyclerView.ViewHolder。 
运行 代码 ， 效 果 如 图 2-37 所 示 。 


erA 


RecyclerView 





图 2-37 RecyclerView 


2. RecyclerView 增加 分 隔 线 

RecyclerView 是 没有 android:divider 与 android:dividerHeight 属性 的 ， 如 果 需 要 分 隔 线 ， 只 能 
自己 动手 去 实现 。 

@ 需要 继承 ItemDecoration 类 ， 实 现 onDraw 与 getItemOffsets 方法 。 

@ 调用 RecyclerView 的 addItemDecoration 方法 。 


先 编写 一 个 DividerItemDecoration 类 ， 继 承 RecyclerView.ItemDecoration， 在 getltemOffsets 
留 出 item 之 间 的 间隔 ， 然 后 调用 onDraw 方法 绘制 (onDraw 的 绘制 优先 于 每 一 行 的 绘制 ) 。 

Public class DividerItemDecoration extends RecyclerView.ItemDecoration{ 

V 

* RecyclerView 的 布局 方向 ， 默 认 先 赋值 为 纵向 布局 

* RecyclerView 布局 可 横向 ， 也 可 纵向 

* 横向 和 纵向 对 应 的 分 隔 线 画 法 不 一 样 

*/ 

Private int mOrientation = LinearLayoutManager .VERTICAL; 


private int mItemSize = 17//item 之 间 分 隔 线 的 size， 默 认为 1 

private Paint mPaint;// 绘 制 item 分 隔 线 的 画笔 ， 并 设置 其 属性 

Public DividerItemDecoration (Context context) { 
this(context,LinearLayoutManager .VERTICAL,R.color.colorAccent); 


} 


Public DividerItemDecoration (Context context, int orientation) { 
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this(context,orientation, R.color.colorAccent); 
1 


public DividerItemDecoration (Context context, int orientation, int 
dividerColor){ 
this(context,orientation,dividerColor,1); 


/x 
* @param context 
* eparam orientation 绘制 方向 
* @param dividerColor 分 隔 线 颜 色 ， 颜 色 资源 id 
* @param mItemSize 分 隔 线 宽度 ， 传 入 dp 值 就 行 
WW 
public DividerItemDecoration (Context context, int orientation, int 
dividerColor, int mItemSize){ 
this.mOrientation = orientation; 
if(orientation != LinearLayoutManager.VERTICAL && orientation != 
LinearLayoutManager .HORIZONTAL) { 
throw new IllegalArgumentException ("请 传 入 正确 的 参数 ") ， 


} 

// 把 dp 值 换算 成 px 

this.mItemSize = (int) TypedValue.applyDimension (TypedValue .COMPLEX 
UNIT DIP,mItemSize,context .getResources() .getDisplayMetrics()); 

mPaint = new Paint (Paint.ANTI ALIAS FLAG); 


mPaint.setColor (context .getResources() .getColor (dividerColor)); 


@Override 
Public void onDraw (Canvas c, RecyclerView parent, RecyclerView.State state) { 
if (moOrientation == LinearLayoutManager .VERTICRAL) { 
drawVertical (c,parent) ? 
lelse { 
drawHorizontal (c,parent) ; 
. 
} 


/x* 
* 绘制 纵向 item 分 隔 线 
* @param canvas 
* @param parent 
网 
Private void drawVertical (Canvas canvas,RecyclerView parent){ 
final int left = Parent.getPaddingLeft() ; 
final int right = Parent .getMeasuredWidth () - Parent .getPaddingRight () 7 
final int childSize = parent.getChildCount() ; 
tor(tint 4 = 0 Fi < childsize 7 1 +){ 
final View child = parent.getChildAt( i )，; 
RecyclerView.LayoutParams layoutParams = 
(RecyclerView.LayoutParams) child.getLayoutParams (); 
final int top = child.getBottom() + layoutParams.bottomMargin ; 
final int bottom = top + mItemSize ; 
canvas .drawRect (left, top,right,bottom,mPaint); 
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} 


J/ 
* 绘制 横向 item 分 隔 线 
* @param canvas 
* @param parent 
Private void drawHorizontal (Canvas canvas,RecyclerView parent){ 
final int top = parent.getPaddingTop() ; 
final int bottom = parent.getMeasuredHeight() - 
Parent .getPaddingBottom() ; 
final int childSize = parent.getChildCount() ; 
for(int i = 0 ; i < childSize ; i ++){ 
final View child = Parent.getChildat( i ) 
RecyclerView.LayoutParams layoutParams = 
(RecyclerView.LayoutParams) child.getLayoutParams (); 
final int left = child.getRight() + layoutParams.rightMargin ; 
final int right = left + mItemSize ; 
canvas.drawRect (left, top,right,bottom,mPaint); 


} 


光 5 
设置 item 分 隔 线 的 size 
@param outRect 
@param view 
@param parent 
* @param state 
ph 
@Override 
Public void getItemOffsets (Rect outRect, View view, RecyclerView parent, 
RecyclerView.State state) { 


汪汪 二 二 汪汪 





OA 
if (morientation == 
LinearLayoutManager .VERTICAL) { RecyclerView 
outRect.set (0,0,0,mItemSize) 7 本 
本 
// 垂 直 排列 , 底部 偏 移 
Jelse { item:1 
outRect .set (0,0,mItemSize,0); 
// 水 平 排列 ,右边 偏 移 item:2 
} : item:3 
} item:4 
不 要 忘记 调用 addItemDecoration 方法 哦 ! item:5 
recyclerView.addItemDecoration (new item:6 


DividerItemDecoration (this) ) ;// 添 加 分 隔 线 


item:7 





新 运行 ， 效 果 如 图 2-38 所 示 。 item:8 

大 家 读 到 这 里 肯定 会 有 一 个 疑问 ， 这 个 比 ListView 麻烦 多 | iem:e 
了 ， 但 是 Google 官方 为 什么 要 说 是 ListView 的 升级 版 呢 ? 接 下 
来 开始 放大 招 。 图 2-38 添加 分 隔 线 
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3. GridLayoutManager 

在 RecyclerView 中 实现 不 同 的 列表 ， 只 需 切 换 不 同 的 LayoutManager (布局 管理 器 ) 即 可 。 
RecyclerView.LayoutManager 与 RecyclerView.ItemDecoration 一 样 ， 都 是 RecyclerView 静态 抽象 内 
部 类 ， 但 是 LayoutManager 有 三 个 官方 写 好 的 实现 类 。 

e@ LinearLayoutManager ( 线性 布局 管理 器 ) 与 ListView 功能 相似 。 

ee GridLayoutManager ( 网 格 布局 管理 器 ) 与 GridView 功能 相似 。 

e@ StaggeredGridLayoutManager ( 瀑布 流 布局 管理 器 )。 


刚刚 用 的 是 LinearLayoutManager， 现 在 切换 到 GridLayoutManager。 看 到 下 面 这 名 代码， 有 没 
有 感觉 到 很 轻松 呢 ? 


recyclerView.setLayoutManager (new GridLayoutManager (this,2)); 


如 果 要 显示 多 列 或 者 要 纵向 显示 ， 只 需 新 建 不 同 的 构造 方法 即 可 。 以 下 代码 纵向 显示 4 列 。 
当然 ， 如 果 还 需要 反方 向 显示 ， 把 false 改 成 true 即 可 。 


recyclerView.setLayoutManager (new 
GridLayoutManager (this,4,GridLayoutManager .HORIZONTAL, false)) 


因为 用 的 是 网 格 布局 ， 所 以 绘制 分 隔 线 的 代码 需要 重新 修改 一 下 。 网 格 布局 一 行 可 以 有 多 列 ， 
并 且 最 后 一 列 与 最 后 一 行 不 需要 绘制 ， 所 以 需要 重新 创建 一 个 类 : DividerGridItemDecoration.java。 


Public class DividerGridItemDecoration extends RecyclerView.ItemDecoration { 
/* 
* RecyclerView 的 布局 方向 ， 默 认 先 赋值 为 纵向 布局 
* RecyclerView 的 布局 可 横向 ， 也 可 纵向 
* 横向 和 纵向 对 应 的 分 隔 线 画 法 不 一 样 
* */ 
Private int mOrientation = LinearLayoutManager .VERTICAL; 


private int mItemSize = 1;//item 之 间 分 隔 线 的 size， 默 认为 1 
private Paint mPaint;// 绘 制 item 分 隔 线 的 画笔 并 设置 其 属性 


Public DividerGridItemDecoration(Context context) { 
this (Context,LinearLayoutManager .VERTICAL,R.color.colorAccent); 
} 


Public DividerGridItemDecoration(Context context, int orientation) { 
this(context,orientation, R.color.colorAccent); 
} 


Public DividerGridItemDecoration(Context context, int orientation, int 
dividerColor){ 
this (context,orientation,dividerColor,1); 
二 


太太 

* @param context 

* @param orientation 绘制 方向 

* @param dividerColor 分 隔 线 颜色 ， 颜 色 资源 id 
* @param mItemSize 分 隔 线 宽度 ， 传 入 dp 值 就 行 
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和 
public DividerGridItemDecoration(Context context, int orientation, int 
dividerColor, int mItemSize){ 
this.mOrientation = orientation; 
if(orientation != LinearLayoutManager.VERTICAL && orientation != 
LinearLayoutManager .HORIZONTAL) { 
throw new IllegalArgumentException ("请 传 入 正确 的 参数 ") ，; 


| 

// 把 dp 值 换算 成 px 

this.mItemSize = (int) TypedValue.applyDimension (TypedValue. 
COMPLEX UNIT DIP, mItemSize,context.getResources() .getDisplayMetrics()); 

mPaint = new Paint (Paint.ANTI ALIAS FLAG); 


mPaint.setColor (context .getResources () .getColor (dividerColor)); 


| 


@Override 

Public void onDraw (Canvas c, RecyclerView parent, RecyclerView.State state) { 
drawHorizontal (c, parent); 
drawVertical(c, parent); 


} 


private int getSpanCount (RecyclerView parent) { 
// 列 数 
int spanCount = -1; 
RecyclerView.LayoutManager layoutManager = parent .getLayoutManager (); 
if (layoutManager instanceof GridLayoutManager) { 
spanCount = ((GridLayoutManager) layoutManager) .getSpanCount (); 
} else if (layoutManager instanceof StaggeredGridLayoutManager) { 
spanCount=( (StaggeredGridLayoutManager) layoutManager) .getSpanCount (); 
return spanCount; 
上 


Public void drawHorizontal (Canvas canvas, RecyclerView parent) { 

int childCount = parent.getChildCount(); 

for (int i = 0; i < childCount; i++) { 
final View child = parent.getChilgAt (i); 
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams 

child.getLayoutParams () 7 

final int left = child.getLeft() - params.leftMargin; 
final int right = child.getRight() + params.rightMargin + mItemSize; 
final int top = child.getBottom() + params.bottomMargin; 
final int bottom = top + mItemSize; 
canvas .drawRect (left, top,right,bottom,mPaint); 


1 


public void drawVertical (Canvas canvas, RecyclerView Parent) { 
final int childCount = parent.getChildCount (); 
Eor (int i = OF 1 < childCcount? itr)y { 
final View child = parent.getChilgAt (i); 


final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) 
child.getLayoutParams (); 
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final int top = child.getTop() - params.topMargin; 

final int bottom = child.getBottom() + params.bottomMargin; 
final int left = child.getRight() + params.rightMargin; 
final int right = left + mItemSize; 

canvas.drawRect (left,top,right,bottom,mPaint); 


} 


@Override 
public void getItemOffsets (Rect outRect, int itemPosition,RecyclerView 
parent) { 
int spanCount = getSpanCount (parent); 
int childCount = parent.getAdapter() .getItemCount (); 


if (isLastRow (parent, itemPosition, spanCount, childCount)){ 
// 如 果 是 最 后 一 行 ， 不 需要 绘制 底部 
outRect.set (0, 0, mItemSize, 0); 
} else if (isLastColum(parent, itemPosition, spanCount, childCount)){ 
// 如 果 是 最 后 一 列 ， 不 需要 绘制 右边 
outRect.set (0, 0, 0, mItemSize); 
} else { 
outRect.set (0, 0, mItemSize,mItemSize); 
} 
} 


Private boolean isLastColum(RecyclerView parent, int pos, int spanCount, 
int childCount) { 
RecyclerView.LayoutManager layoutManager = parent .getLayoutManager (); 
if (layoutManager instanceof GridLayoutManager) { 
if ((pos + 1) % spanCount == 0){// 如 果 是 最 后 一 列 ， 不 需要 绘制 右边 
return true; 
} 
} else if (layoutManager instanceof StaggeredGridLayoutManager) { 
int orientation = ((StaggeredGridLayoutManager) 
layoutManager) .getOrientation(); 
if (orientation == StaggeredGridLayoutManager .VERTICAL) 
if ((pos + 1) % spanCount == 0){// 如 果 是 最 后 一 列 ， 不 需要 绘制 右边 
return true; 
1 
] .else 
childCount = childCount - childCount % spanCount; 
if (pos >= childcount)// 如 果 是 最 后 一 列 ， 不 需要 绘制 右边 
return true; 
} 
1 
return false; 
1 


Private boolean isLastRow (RecyclerView parent, int pos, int spanCount, int 
childCount) { 
RecyclerView.LayoutManager layoutManager = parent .getLayoutManager (); 
if (layoutManager instanceof GridLayoutManager) { 
childCount = childCount - childCount % spanCount; 
if (pos >= childcount)// 最 后 一 行 
return true; 
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} else if (layoutManager instanceof StaggeredGridLayoutManager) { 
int orientation = ((StaggeredGridLayoutManager) layoutManager). 
getOrientation(); 
if (orientation == StaggeredGridLayoutManager .VERTICAL) {// 纵 向 
childCount = childCount - childCount % spanCount; 
if (pos >= childcount)// 最 后 一 行 
return true; 
} else{ // 横 向 
if ((pos + 1) % spanCount == 0) {// 最 后 一 行 
return true; 























} 


©A5 


} 


RecyclerView 
return false; sh 





item:0 item:1 


item;2 item:3 


写 了 这 两 个 画 分 隔 线 的 类 和 主流 的 布局 ， 线 性 列表 与 网 格 列表 tem:4 item:5 
都 能 展示 了 。 运 行 代码 ， 结 果 如 图 2-39 所 示 。 item:6 item:7 


4. StaggeredGridLayoutManager item:8 item:9 
在 Activity 页 面 中 修改 布局 管理 器 ， 大 家 应 该 很 熟悉 了 。 


recyclerView.setLayoutManager (new 
StaggeredGridLayoutManager (3, StaggeredGridLayoutManag tem:14 item:15 
er.VERTICAL)); 


- 般 瀑布 流 列表 的 列 高 度 是 不 一 致 的 ， 为 了 模拟 不 同 的 宽 高 ， 
把 String 类 型 改 成 对 象 ， 然 后 初始 化 时 随机 一 个 高 度 即 可 。 图 2.39 线性 列表 与 网 格 列表 


Public class ItemData { 
private String content;//item 内 容 
private int height;//itenm 高 度 


item:11 





item:13 


tem:16 item:17 


item:19 





public ItemData() { 


Public ItemData (String content, int height) { 
this.content = content; 
this.height = height; 


public String getContent () { 
return content; 


} 


Public void setContent (String content) { 
this .content = content; 


Public int getHeight() { 
return height; 


上 


Public void setHeight (int height) { 
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this.height = height; 
} 
对 应 的 适配器 代码 StaggeredGridA dapter.java: 


public class StaggeredGridAdapter extends 
RecyclerView.Adapter<StaggeredGridAdapter.MyViewHolder>{ 
private List<ItemData> datas; 
Private LayoutInflater inflater; 


Public StaggeredGridAdapter (Context context, List<ItemData> datas){ 
inflater=LayoutIinflater.from(context); 
this.datas=datas; 


/ /创建 每 一 行 的 View， 用 RecyclerView.ViewHolder 包装 
@Override 
public StaggeredGridAdapter.MyViewHolder onCreateViewHolder (ViewGroup 
parent, int viewType) { 
View itemView=inflater.inflate(R.layout.recycler staggered item, 
Parent, false); 
return new MyViewHolder (itemView); 


} 
// 给 每 一 行 View 填充 数据 


@Override 
public void onBindViewHolder (StaggeredGridAdapter .MyViewHolder holder, 
int position) { 
ItemData itemData=datas.get (position); 
holder.textview.setText (itemData.getContent ()); 
// 手 动 更 改 高 度 ， 不 同位 置 的 高 度 有 所 不 同 
holder.textview.setHeight (itemData.getHeight ()); 
上 


// 数 据 源 的 数量 

@Override 

public int getItemCount() { 
return datas.size(); 

} 


class MyViewHolder extends RecyclerView.ViewHolder{ 
Private TextView textview; 


Public MyViewHolder (View itemView) { 
super (itemView); 
textview= (TextView) itemView.findViewById(R.id.textview); 


} 

需要 注意 的 是 ， 我 们 在 适配器 的 onBindViewHolder 方法 中 给 item 布局 中 的 TextView 设置 了 
一 个 高 度 ， 这 个 高 度 是 创建 实体 类 的 时 候 随机 生成 的 。 

item 对 应 的 布局 文件 : recycler_staggered_item.xml。 
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<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:padding="5dp" 
android:layout width="wrap content" 
android:layout height="match parent"> 


<TextView 

android:id="@+id/textview" 

:background="@color/colorAccent" 

:layout width="100dp" 

:layout height="wrap content" 
android:gravity="center" 
android:text="122" 
android:textSize="20sp"/> 

</FrameLayout> 


瀑布 流 列表 没有 添加 分 割 线 ， 为 了 展示 效果 ， 给 item 布局 设置 了 android:padding 属性 。 
是 不 是 感觉 很 容易 ? 赶紧 运行 代码 ， 查 看 效果 ， 整 个 页 面 看 起 来 变 得 生动 活泼 了 ， 如 图 2-40 
所 示 。 






ea 


RecyclerVi 





5. 添加 header 和 footer 


RecyclerView 添加 头 部 与 底部 是 没有 对 应 的 api 的 , 但 是 很 多 需求 都 会 用 到 ,于 是 只 能 自己 想 
办 法 实现 了 。 可 以 通过 适配器 的 getItemViewType 方法 来 实现 这 个 功能 。 
修改 后 的 适配器 代码 : RecyclerHeadFootViewAdapterjava。 


Public class RecyclerHeadFootViewAdapter extends 
RecyclerView.Adapter<RecyclerView.ViewHolder>{ 
Private List<String> datas; 
private LayoutInflater inflater; 


public static final int TYPE HEADER=1;//header 类 型 
public static final int TYPE FOOTER=2;//footer 类 型 
private View header=null;// 头 View 
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private View footer=null;// 脚 View 


public RecyclerHeadFootViewAdapter (Context context, List<String> datas){ 
inflater=LayoutInflater.from(context); 
this.datas=datas; 

} 


// 创 建 每 一 行 的 View， 用 RecyclerView.ViewHolder 包装 
@Override 
public RecyclerView.ViewHolder onCreateViewHolder (ViewGroup parent, int 


viewType) { 


if (viewType==TYPE HEADER){ 
return new RecyclerView.ViewHolder (header) {}; 
}else if(viewType==TYPE FOOTER){ 
return new RecyclerView.ViewHolder (footer){}; 
} 
View itemView=inflater.inflate(R.layout.recycler item,null); 
return new MyViewHolder (itemView); 


} 
// 给 每 一 行 View 填充 数据 


@Override 
public void onBindViewHolder (RecyclerView.ViewHolder holder, int 


position){ 


if (getIitemViewType (position)==TYPE HEADER| |getIitemViewType (Position) 
==TYPE_ FOOTER) { 
return; 
: 
MyViewHolder myholder= (MyViewHolder) holder; 
myholder .textview.setText (datas .get (getRealPosition (position))); 
. 


// 如 果 有 头 部 ，position 的 位 置 是 从 1 开始 的 ， 所 以 需要 -1 

Public int getRealPosition(int position){ 
return header==null?position:position-1; 

用 


// 数 据 源 的 数量 
@Override 
public int getItemCount () { 
if(header == null && footer == null) {// 没 head 跟 foot 
return datas.size(); 
}else if(header == null && footer != null){//head 为 空 &&foot 不 为 空 
return datas.size() + 1; 
}else if (header != null && footer == null){//head 不 为 空 &&foot 为 空 
return datas.size() + 17 
yelse { 
return datas.size() + 2;//head 不 为 空 &&foot 不 为 空 


} 


@Override 
Public int getIitemViewType (int position){ 
// 如 果 头 布局 不 为 空 &g 位 置 是 第 一 个 那 就 是 head 类 型 


if (header!=null&&position==0) 1{ 
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return TYPE HEADER; 
}else if(footer!=null&&position==getItemCount ()-1) 1 
// 如 果 footer 不 为 空 &g 最 后 一 个 
return TYPE FOOTER7 
} 
return super.getIitemViewType (position); 


| 


Public void setHeader (View header) { 
this.header = header; 


notifyItemInserted(0) ;// 在 位 置 0 处 插入 一 条 数据 ， 然 后 刷新 
} 


Public void setFooter (View footer) { 
this .footer = footer; 


notifyItemInserted (datas .size()-1);// 在 尾部 插入 一 条 数据 ， 然 后 刷新 


class MyViewHolder extends RecyclerView.ViewHolder{ 
Private TextView textview; 


public MyViewHolder (View itemView) { 
super (itemView); 
textview= (TextView) itemView.findViewById(R.id.textview); 


getItemCount: 有 header 和 footer 时 ， 需 要 在 源 数据 长 度 基础 上 进行 增加 。 

getltemViewType: 通过 getltemViewType 判断 不 同 的 类 型 。 

onCreateViewHolder: 通过 不 同 的 类 型 创建 item 的 View 。 

onBindViewHolder: 如 果 是 header 与 footer 类 型 是 不 需要 绑 定 数据 的 ,header 与 footer 的 View 
一 般 在 Activity 页 面 中 创建 ， 不 需要 处 理 ， 所 以 这 两 种 类 型 就 不 往 下 执行 。 如 果 有 头 布局 ， 
position 一 0 的 位 置 就 会 被 header 占用 ， 但 是 数据 源 也 就 是 集合 的 下 标 是 从 0 开始 的 ， 所 以 这 
里 需要 改 为 -1。 

setHeader: 设置 头 布局 ， 在 第 一 行 插入 一 条 数据 ， 然 后 刷新 。 注 意 ， 这 个 方法 调用 后 会 有 插 
入 的 动画 ， 这 个 动画 可 以 使 用 默认 的 ， 也 可 以 自己 定义 。 

setFooter: 设置 尾部 布局 ， 在 尾部 插入 一 条 数据 ， 然 后 刷新 。 


添加 header 与 footer 的 方法 终于 封装 好 了 ,在 Activity 页 面 中 只 需要 两 行 代码 就 能 添加 header， 
与 ListView 调用 addHeader 方法 一 样 简单 。 这 里 需要 注意 的 是 ， 初 始 化 View 时 ，inflate 方法 需要 
三 个 参数 。 


resource: 布局 文件 资源 id。 

root: 父 View。 

attachToRoot: 需要 传 入 一 个 boolean 类 型 的 值 。 如 果 传 入 true， 布 局 文件 将 转化 为 View 并 绑 
定 到 root， 然 后 返回 root 作为 根 节 点 的 整个 View。 如 果 传 入 false， 布 局 文件 转化 为 View 但 
不 绑 定 到 root， 返 回 以 布局 文件 根 节点 为 根 节点 的 View。 
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// 添 加 header 


View header=LayoutInflater.from(this) .inflate(R.layout.recycler header, 
recyclerView, false) 
adapter.setHeader (header); 


// 添 加 footer 


View footer=LayoutIinflater.from(this) .inflate (R.layout.recycler footer, 
recyclerView,false); 
adapter.setFooter (footer); 


recycler_header 和 recycler_footer 布局 文件 只 有 一 个 TextView， 直 接 看 效果 ， 如 图 2-41 所 示 。 
OA 309PM 


RecyclerView 


item:0 
item:1 


item:2 


item:3 





item:4 





图 2-41 头 布局 与 底部 布局 


6. item 点 击 事件 && 增 加 或 删除 带动 画 效果 

当 调 用 RecyclerView 的 setOnItemClickListener 方法 时 , 发 现 居然 没有 该 方法 。 用 RecyclerView 
要 习惯 什么 东西 都 自己 封装 。 

首先 从 adapter 着 手 ， 内 部 写 一 个 接口 、 一 个 实例 变量 ， 提 供 一 个 公共 方法 ， 设 置 监听 。 


Private RecyclerViewItemClick recyclerViewItemClick; 


Public void setRecyclerViewItemClick (RecyclerViewItemClick 
recyclerViewItemClick) { 
this.recyclerViewItemClick = recyclerViewItemClick; 


1 


Public interface RecyclerViewItemClickt{ 

/** 

* item 点 击 

* @param realPosition 数据 源 position 

* @param position view position 

全 

void onItemClick(int realPosition,int Position) 
由 


在 onBindViewHolder 方法 中 为 item 监听 点 击 事件 : 


if(recyclerViewItemClick!=null) { 
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myholder.itemView.setOnClickListener (new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
recyclerViewItemClick.onItemClick(getRealPosition (position), 
position); 


]) 7 
1 
在 Activity 页 面 的 onCreate 方法 中 进行 监听 , 顺便 设置 item 增加 或 删除 动画 ， 用 的 是 SDK 自 
带 的 默认 动画 。 
adapter.setRecyclerViewItemC1lick (recyclerViewItemClick) 7; 
recyclerView.setItemAnimator (new DefaultItemAnimator()); 
Private RecyclerHeadFootViewAdapter.RecyclerViewItemClick 
recyclerViewItemClick=new RecyclerHeadFootViewAdapter.RecyclerViewItemClick() { 
@Override 
public void onItemClick(int realPosition, int position) { 
Log .i ("ansen", "删除 数据 realPosition+" view 位置 :"+position)，; 
Log.i("ansen", "当前 位 置 :"+position+" 更 新 item 数量 : 
"+(adapter.getIitemCount ()-position-1)); 








datas .remove (realPosition) ;// 删 除数 据 源 

adapter.notifyItemRemoved (position) ;//item 移 除 动画 

// 更 新 position 至 adapter.getItemCount ()-1 的 数据 

adapter.notifyItemRangeChanged (position,adapter.getItemCount () 
-position-1); 


2.5.4 ”SwipeRefreshLayout (下 拉 刷 新 ) 


SwipeRefreshLayout 是 一 种 下 拉 刷 新 控件 ， 在 Version 19.1 之 后 被 放 到 support v4 中 ， 继 承 自 
ViewGroup 。 SwipeRefreshLayout 控件 只 允许 有 一 个 子 元 素 ， 子 元 素 一 般 是 ListView 或 者 
RecyclerView 。 

1. SwipeRefreshLayou 下 拉 刷 新 

-一 节 学 习 了 RecyclerView， 这 里 就 在 RecyclerView 简单 Demo 的 基础 上 加 上 下 拉 刷 新 。 
首先 看 布局 文件 activity_main.xml， 把 最 外 层 的 布局 控件 换 成 SwipeRefreshLayout。 


<?xml version="1.0" encoding="utf-8"?> 
<android.support .v4.widget .SwipeRefreshLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/swipeRefreshLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<RecyclerView 
android:id="@+id/recyclerview" 
android:layout width="match parent" 
android:layout height="match parent"/> 
</android.support .v4.widget .SwipeRefreshLayout> 
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接 下 来 ， 在 Activity 页 面 中 设置 刷新 监听 ， 设 置 刷新 箭头 的 颜色 : 


swipeRefreshLayout= (SwipeRefreshLayout) findViewById(R.id.swipeRefreshLayou 


// 监 听 刷 新 状态 

swipeRefreshLayout.setOnRefreshListener (this); 

// 设 置 下 拉 刷 新 的 箭头 颜色 (可 以 设置 多 个 颜色 ) 

swipeRefreshLayout.setColorSchemeResources (R.color.colorAccent, 
android.R.color.holo green light,R.color.colorPrimary); 


刷新 监听 回调 方法 ， 这 里 为 了 模拟 访问 网 络 请 求 ， 用 Handle 来 达到 延 时 的 效果 。 有 关 Handle 
的 使 用 方法 ， 后 续 的 章节 会 详细 介绍 。 
@Override 


Public void onRefresh() { 


// 延 迟 3000 毫秒 , 发 送 空 消息 跟 handle，handle 的 handleMessage 方法 会 接收 到 
handler.sendEmptyMessageDelayed (PULL TO REFRESH,3000); 


t; 


PULL_TO_REFRESH 是 一 个 常量 ， 在 Activity 中 定义 如 下 : 
public static final int PULL TO REFRESH=1;// 下 拉 刷 新 


下 面 来 看 Handle 是 怎么 实现 的 ， 可 以 通过 msg 对 象 的 what 来 判断 是 什么 消息 。 


Private Handler handler=new Handler(){ 
@Override 
Public void handleMessage (Message msg) { 
Switch (msg.what){ 
case PULL TO REFRESH:// 下 拉 刷 新 
if(datas.size()>0){ 
datas .remove (0) ;// 删 除 第 一 条 
adapter.notifyDataSetChanged() ;// 更 新 第 一 条 记录 
swipeRefreshLayout.setRefreshing (false) 
//false， 刷 新 完成 ; true， 正 在 刷新 
} 
break; 


}; 


通过 上 面 为 数 不 多 的 代码 ， 就 实现 了 RecyclerView 下 拉 刷 新 的 效果 。 运 行 代码 ， 正 在 刷新 中 
的 效果 如 图 2-42 所 示 。 
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图 2-42 正在 刷新 中 
2. RecyclerView 加 载 更 多 
既然 有 了 下 拉 刷 新 功能 ,肯定 还 需要 加 载 更 多 ,在 SwipeRefreshLayout 控件 的 api 中 并 没有 这 
个 功能 ， 只 能 从 RecyclerView 入 手 。 
首先 修改 item 布局 文件 recycler item.xml， 增 加 ProgressBar 进度 条 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="vertical"> 


<TextView 
android:id="@+id/textview" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:padding="10dp" 
android:text="122" 
android:textSize="20sp"/> 


<ProgressBar 

android:id="@+id/progressBar" 
style="@style/Widget.AppCompat.ProgressBar" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:padding="3dp" /> 

</LinearLayout> 


在 adapter 内 部 类 MyViewHolder 中 查找 这 个 控件 : 


class MyViewHolder extends RecyclerView.ViewHolder{ 
Private TextView textview; 
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Private ProgressBar progressBar; 


public MyViewHolder (View itemView) { 
super (itemView); 
textview= (TextView) itemView.findViewById(R.id.textview); 
progressBar= (ProgressBar) itemView.findViewById(R.id.progressBar); 


} 


在 adapter 中 的 onBindViewHolder 方法 增加 以 下 代码 : (如 果 列 表 有 5 条 记录 并 且 是 最 后 一 条 
记录 ， 将 显示 进度 条 ， 否 则 隐藏 进度 条 。) 


if(position>5 && position == datas.size()-1){ 
holder.progressBar.setVisibility(View.VISIBLE); 
}elsef{ 


holder.progressBar.setVisibility(View.GONE); 
} 


在 Activity 页 面 中 监听 recyclerView 滚动 : 
recyclerView.addonScrollListener (onScrollListener); 
下 面 用 一 个 实例 变量 控制 加 载 状态 : 


Private RecyclerView.OnScrollListener onScrollListener=new 
RecyclerView.OnScrollListener() { 
@Override 
Public void onScrolled (RecyclerView recyclerView, int dx, int dy) { 
super.onScrolled (recyclerView, dx, dy); 
RecyclerView.LayoutManager mLayoutManager = recyclerView. 
getLayoutManager (); 
int lastVisibleItem = ((LinearLayoutManager) mLayoutManager). 
findLastVisibleItemPosition(); 
int totalItemCount = mLayoutManager .getItemCount (); 
// 最 后 一 项 显示 &g 下 滑 状 态 的 时 候 回调 加 载 更 多 
if (lastVisibleItem >= totalItemCount-l && dy > 0) { 
if(!isLoadMore)1{ 
loadMore () ;// 加 载 更 多 
isLoadMore=true; 


加 载 更 多 的 方法 ， 模 拟 访问 网 络 延迟 1000 毫秒 给 handle 发 送 一 个 消息 : 


public void loadMore() { 
handler.sendEmptyMessageDelayed (UP TO REFRESH,1000); 
} 


为 在 handle 中 判断 what 的 switch 增加 一 个 case,， 这 里 要 加 载 更 多 ,为 列表 增加 三 行 数据 。 在 
企业 开发 中 ， 基 本 都 是 请 求 下 一 页 数据 ， 然 后 更 新 列表 。 
case UP TO REFRESH:// 上 拉 加 载 更 多 
for(int T=0;1ic3314t) | 


datas.add ("load more item:"+i); 
| 
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adapter.notifyDataSetChanged() ;// 更 新 列表 
isLoadMore=false;// 加 载 更 多 完成 
break; 
因为 书 中 能 展示 的 代码 有 限 ， 所 以 都 是 展示 要 修改 的 代码 ， 如 果 大 家 看 起 来 有 困难 ， 可 以 对 
照 源 代码 学 习 。 运 行 代码 ， 有 一 个 波纹 效果 ， 这 是 5.0 操作 系统 自 带 的 ， 如 图 2-43 所 示 。 
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图 2-43 ”RecyclerView 的 效果 


2.5.5 ”ViewPager( 翻 页 视图 ) 


ViewPager 是 Android 扩展 包 v4 中 的 类 ， 可 以 让 用 户 左 右 切 换 View。ViewPager 的 用 法 与 
ListView 类 似 , 需要 设置 PagerAdapter 来 完成 页 面 和 数据 的 绑 定 , 这 个 PagerAdapter 是 一 个 基 类 适 
配器 , 经 常用 来 实现 App 引导 图 。 它 的 子 类 有 FragmentPagerAdapter 和 FragmentStatePagerAdapter， 
和 Fragment 一 起 使 用 。 在 Android 应 用 中 ， 它 们 就 像 ListView 一 样 出 现 得 较 频 繁 。 

本 节 实 例 将 用 ViewPager 来 实现 Fragment 的 滑动 。 

首先 看 布局 文件 activity_main.xml， 外 层 是 RelativeLayout， 里 面包 含 一 个 ViewPager 控件 : 

<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match Parent" 
android:layout height="match parent"> 


<android.support .v4.view.ViewPager 
android:id="@+id/viewPager" 
android:layout width="match parent" 
android:layout height="match parent"/> 
</RelativeLayout> 


接 下 来 看 布局 文件 对 应 的 Activity 如 何 实现 ， 首 先 查 找 Viewpager 控件 ， 设 置 缓存 页 数 ， 设 置 
当前 显示 第 几 个 Fragment， 然 后 初始 化 FragmentAdapter 适配器 ， 这 个 适配器 是 我 们 自己 写 的 ， 集 
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成 自 FragmentStatePagerAdapter， 接 下 来 调用 适配器 的 addFragment 方法 将 要 显示 的 Fragment 添加 
进去 。 最 后 调用 ViewPager 的 setAdapter 方法 将 适配器 设置 进去 。 当 想 知道 ViewPager 滑动 到 哪个 
Fragment 时 ， 可 以 通过 addOnPageChangeListener 方法 来 设置 监听 。 


public class MainActivity extends AppCompatActivity { 
QOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


ViewPager vPager = (ViewPager) findViewById(R.id.viewPager); 
vPager .setOffscreenPageLimit (2) ;// 设 置 缓存 页 数 
vPager.setCurrentItem(0);// 设 置 当 前 显示 的 item 0 表示 显示 第 一 个 


FragmentAdapter pagerAdapter = new FragmentAdapter 
(getSupportFragmentManager ()); 


pagerAdapter.addFragment (new FragmentTest ("页 面 1",android.R.color. 
holo red dark)); 

pagerAdapter.addFragment (new FragmentTest ("页 面 2",android.R.color. 
holo green dark)); 

pagerAdapter.addFragment (new FragmentTest ("页 面 3",android.R.color. 
holo red dark)); 

pagerAdapter.addFragment (new FragmentTest ("页 面 4",android.R.color. 
holo green dark)); 


// 给 ViewPager 设置 适配器 

vPager .setAdapter (pagerAdapter); 

// 页 面 改变 监听 

vPager.addonPageCchangeListener (onPageChangeListener); 
} 


Private ViewPager.OnPageChangeListener onPageChangeListener=new ViewPager. 
OnPageChangeListener() { 
// 页 面 滑动 
@Override 
Public void onPageScrolled(int position, float positionOoffset, int 
positionOffsetPixels) {} 


// 页 面 选 择 

@Override 

Public void onPageSelected (int Position) { 
Log.i("MainRctivity"," 选 中 了 页 面 "+ (Position+1) ) 7 

} 


// 页 面 滑动 状态 改变 
@Override 
Public void onPageScrollStateChanged (int state) {} 


} 


FragmentAdapter.java 继承 FragmentStatePagerAdapter 类 ， 与 BaseAdapter 有 点 类 似 。 相 对 于 
BaseAdapter 适配器 ，FragmentStatePagerAdapter 不 需要 重 写 getView 方法 。 
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public class FragmentAdapter extends FragmentStatePagerAdapter { 


} 


private final List<Fragment> fragmentList = 


public FragmentAdapter (FragmentManager fm) { 
super (fm); 
| 


@Override 

public Fragment getItem(int arg0) { 
return fragmentList.get (arg0); 

J); 


@Override 
public int getCount() { 
return fragmentList.size(); 


} 


Public void addFragment (Fragment fragment) { 
fragmentList.add (fragment) 7 
} 


new ArrayList<Fragment>(); 


FragmentTest.xml 在 构造 方法 中 传 入 两 个 参数 ， 参 数 1 是 内 容 ， 参 数 2 是 页 面 背景 颜色 。 
fragment_test.xml 只 有 一 个 TextView， 非 常 简单 ， 代 码 就 不 贴 出 来 了 。 


@SuppressLint ("ValidFragment") 
public class FragmentTest extends Fragment { 


} 


Private String content; 
Private int backgroundResourcelId; 


Public FragmentTest (String content,int backgroundResourceId){ 


this.content=content; 


this.backgroundResourceId=backgroundResourcelId; 


1 


@Override 


Public View onCreateView (LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState){ 


View rootView=LayoutIinflater.from(getActi 
fragment test, null); 


vity()) .inflate (R.1layout. 


TextView tvContent= (TextView) rootView.findViewById 


(R.id.tv content); 
tvContent .setText (content); 


rootView.setBackgroundResource (backgroundResourceId) 


return rootView; 


效果 如 图 2-44 所 示 。 这 是 ViewPager 滑动 到 一 半 的 截图 ， 页 面 一 和 页 面 二 都 显示 一 半 。 
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ViewPager 





图 2-44 翻 页 视图 


2.6 ”通过 xml 文件 修饰 View 


2.6.1 shapes (设置 圆 角 、 边 框 、 填 充 色 、 渐 变色 ) 


shape 用 来 控制 控件 (View) 的 几何 形状 ， 有 6 个 子 标签 : 


comers: 贺 角 。 
solid: 填充 颜色 。 
stroke: 描 边 。 
padding: 内 边 距 。 
size: 宽 高 。 


gradient: 渐变 。 


在 res/drawable 目录 下 新 建 一 个 文件 tv_shape.xml: 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 圆 角 --> 
<corners android:radius="10dp"/> 
<!-- 填 充 颜 色 --> 
<solid android:color="@android:color/white"/> 
<!-- 描 边 --> 
<stroke 
android:width="5dp" 
android:color="@color/colorAccent" /> 
<!-- 内 边 距 --> 
<padding android:top="10dp"” android:bottom="10dp" android:left="10dp" 
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android:right="10dp"/> 
</shape> 


在 布局 文件 中 为 TextView 设置 background， 引 用 刚刚 写 的 shape。 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:background="@drawable/tv shape" 
android:text="Hello World!" /> 


效果 如 图 2-45 所 示 。 





图 2-45 设置 圆 角 图 形 


因为 渐变 色 和 填充 色 不 能 同时 使 用 , 所 以 接着 为 渐变 色 新 建 一 个 shape 文 件 tv_shape_two.xml， 
顺便 增加 一 个 size 标签 ， 指 定 该 View 的 宽 高 都 是 100dp。 


<?xml Version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 宽 高 --> 
<size 
android:width="100dp" 
android:height="100dp" /> 
< 
<gradient 
android:endColor="#ff8c00" 
android:gradientRadius="50" 
android:startColor="#FFFFFF™" 
android:type="linear" /> 
</shape> 


解释 上 面 的 渐变 标签 ，android:startColor 和 android:endColor 分 别 为 起 始 和 结束 颜色 ， 
android:angle 是 渐变 角度 ， 必 须 为 45 的 整数 倍 。 另 外 ， 渐 变 默认 的 模式 为 android:type="linear"， 
即 线性 渐变 。 可 以 指定 渐变 为 径 向 渐变 ，android:type="radial" ， 径 向 渐变 需要 指定 半径 
android:gradientRadius="50"。 

效果 如 图 2-46 所 示 。 





设置 宽 高 





图 2-46 渐变 效果 
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2.6.2 selector (设置 点 击 、 选 中 点 击 效果 ) 


当 用 户 点 击 界面 的 某 个 按钮 或 者 图 片 的 时 候 ， 需 要 告诉 用 户 : 你 的 点 击 我 收 到 了 。 例 如 ， 大 
部 分 App 注册 时 需要 选择 用 户 性 别 ， 都 可 能 会 用 到 selector。 下 面 介绍 selector 标签 中 item 标签 的 
常用 属性 。 


1. android:state_pressed 属性 
在 drawable 目录 下 新 建 一 个 selector_button_pressed.xml 文件 : 


<?xml version="1.0" encoding="utf-8"?> 

<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 按 下 背景 颜色 --> 
<item android:drawable="Q@color/colorAccent" 

android:state Pressed="true"/> 

<!-- 默 认 背景 颜色 --> 
<item android:drawable="@color/colorPrimary"/> 

</selector> 


给 按钮 设置 一 个 背景 颜色 : 
android:background="@drawable/selector button pressed" 


左边 是 默认 效果 ， 右 边 是 按 下 效果 ， 如 图 2-47 所 示 。 


HELLO WORLD! 导 HELLO WORLD! 


图 2-47 为 按钮 设置 背景 颜色 





2. android:state_checked 


- 般 Checkbox( 复 选 框 ) 使 用 这 个 属性 比较 多 。 在 drawable 目录 下 新 建 一 个 selector_check_state. 
xml 文件 ， 用 android:drawable 引用 图 片 ， 是 之 前 准备 好 的 两 张 图 片 ， 表 示 勾 选 状态 和 未 勾 选 状态 。 


<?xml version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 选 中 时 显示 图 片 --> 
<item android:drawable="@mipmap/icon checkbox selector" 
android:state checked="true" /> 
<!-- 未 选中 时 显示 图 片 --> 
<item android:drawable="@mipmap/icon checkbox normal" 
android:state checked="false" /> 
</selector> 


用 Checkbox 控件 的 android:button 引用 这 个 文件 : 


<CheckBox 
android:layout marginTop="20dp" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:button="@drawable/selector check state"/> 


未 勾 选 状态 跟 勾 选 状态 的 效果 如 图 2-48 所 示 。 
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2-48 ” 复 选 框 的 两 种 状态 
3. android:state_selected 


选中 状态 和 未 选中 状态 其 实 与 android:state_checked 类 似 。 这 个 属性 大 部 分 控件 都 能 使 用 ， 一 
般 需 要 自己 在 代码 中 设置 选中 和 未 选中 状态 。 
新 建 一 个 文件 selector imageview.xml， 引 用 的 图 片 与 上 一 个 属性 图 片 一 样 。 
<?xml version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 选 中 时 显示 图 片 --> 
<item android:drawable="@mipmap/icon checkbox_selector" 
android:state selected="true" /> 
<!-- 未 选中 时 显示 图 片 --> 
<item android:drawable="@mipmap/icon checkbox normal" 
android:state selected="false" /> 
</selector> 


给 ImageView 控件 设置 android:background: 
android:background="@drawable/selector imageview" 
在 MainActivity 中 设置 ImageView 点 击 事件 ， 在 点 击 事件 设置 选中 状态 。 


Q@Override 
public void onClick(View v) { 
// 获 取 状 态 ， 取 反 ， 设 置 取 反 后 的 状态 
imageView.setSelected(!imageView.isSelected()); 
1 


效果 图 和 CheckBox 的 勾 选 效果 一 样 ， 只 不 过 用 的 控件 以 及 selector 的 属性 不 一 样 ， 如 图 2-49 
所 示 。 


Vv 


2-49 ” 复 选 框 的 两 种 状态 


2.6.3 layer-list (把 item 按照 顺序 层 又 显示) 


使 用 layer-list 可 以 将 多 个 drawable 按照 顺序 层 琶 在 一 起 显示 。 最 先 定义 的 在 最 下 方 显示 ， 后 
面 的 依次 往 上 难 放 。 
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在 drawable 目录 下 新 建 layer_list_textview.xml 文件 : 


<?xml Version="1.0" encoding="utf-8"?> 
<layer-list xmlns:android="http://schemas.android.com/apk/res/android"> 
<item > 
<shape android:shape="rectangle" > 
<solid android:color="#0000ff"/> 
</shape> 
</item> 


<item android:bottom="25dp" android:top="25dp" android:1left="25dp" 
android:right="25dp"> 
<shape android:shape="rectangle" > 
<solid android:color="#00ff00"/> 
</shape> 
</item> 


<item android:bottom="50dp" android:top="50dp" android:1left="50dp" 
android:right="50dp"> 
<shape android:shape="rectangle" > 
<solid android:color="#ff0000" /> 
</shape> 
</item> 
</layer-list> 


为 TextView 设置 background 属性 引用 这 个 文件 ， 并 且 设 置 padding 属性 。 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:background="@drawable/layer list textview" 
android:padding="50dp" 
android:text="Hello World!"/> 


如 图 2-50 所 示 , 蓝 色 在 最 底部 (定义 的 第 一 个 item), 红色 在 最 上 面 (定义 的 最 后 一 个 item) 。 


layerlist 





图 2-50 ”layer-list 的 使 用 
> 
2.7 “本章 小 结 


现在 市 场 上 的 应 用 程序 五 花 八 门 ， 每 一 个 类 型 都 有 几 十 个 应 用 程序 相互 党 争 ， 熟 练 使 用 控件 
才能 做 出 更 好 的 App。 本 章 主要 介绍 了 使 用 较 多 的 三 种 布局 以 及 控件 的 使 用 , 每 个 控件 都 提供 了 案 
例 ， 让 读者 加 深 对 组 件 的 理解 。 通 过 本 章 的 学 习 ， 相 信 大 家 在 开发 过 程 中 也 能 灵活 应 用 ， 在 不 同 的 
UI 界 面 上 知道 应 该 使 用 哪 种 控件 最 合适 。 


Android 四 大 组 件 


Android 四 大 核心 组 件 指 的 是 Activity、Service、Broadcast Receiver 和 ContentProvider。 四 大 
组 件 由 Android 系统 进行 管理 和 维护 ， 一 般 都 需要 在 清单 文件 中 注册 或 者 在 代码 中 动态 注册 。 
Activity: 代表 一 个 页 面 (窗口 )。 
Service: 在 后 台 默 默 做 一 些 耗 时 操作 。 
Broadcast Receiver: 对 感 兴趣 的 外 部 事件 进行 监听 ， 例 如 监听 系统 短信 、 手 机 网 络 状态 改变 
等 ， 当 然 也 可 以 监听 自己 发 送 的 广播 。 
@ ContentProvider: 多 个 应 用 程序 之 间 数 据 共享 。 


3.1 Activity (活动 ) 


Activity (活动 ) 是 用 得 最 多 、 最 基本 的 组 件 ， 是 一 种 可 以 包含 界面 的 组 件 。Activity 代表 一 个 
页 面 ， 开 发 者 可 以 通过 setContentView (View) 把 界面 (UI) 放 到 该 页 面 上 。 实 现 Activity 需要 进 
行 以 下 两 步 : 

8 重 写 onCreate 方法 ，Activity 创建 的 时 候 会 调用 这 个 方法 。 

@ 在 onCreate 中 调用 setContentView (int) 设置 界面 布局 ， 并 且 可 以 使 用 findViewByld (int ) 

查找 界面 上 的 某 个 控件 。 


3.1.1 _ Activity 的 生命 周期 


Activity 是 由 Activity 任务 栈 〈 任 务 栈 后 面 介绍 ) 进行 管理 的 。 假 设 我 们 现在 已 经 开启 了 一 个 
Activity A， 当 再 次 开启 一 个 新 的 Activity B 时 ，Activity B 就 会 被 放 到 栈 的 顶部 ， 也 会 标示 成 运行 
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状态 。Activity A 同时 放 到 栈 的 下 面 ， 进 入 后 台 状 态 。 如 果 新 开启 的 Activity B 被 销毁 ，Activity A 
会 继续 回 到 栈 的 顶部 。 

图 3-1 表示 了 Activity 的 生命 周期 ， 正 方形 表示 Activity 在 状态 之 间 切 换 要 回调 的 方法 ， 彩 色 
椭圆 形 表示 Activity 处 于 主要 状态 。 所 谓 的 生命 周期 就 是 Activity 从 创建 到 销毁 的 生命 过 程 。 
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图 3-1 Activity 整个 生命 周期 
我 们 首先 介绍 一 下 正方 形 中 各 方法 的 调用 顺序 。 
® ”onCreate: 该 方法 在 Activity 创建 时 调用 ， 是 整个 生命 周期 中 第 一 个 调用 的 方法 ， 我 们 在 创建 
一 个 Activity 时 一 般 都 要 重 写 这 个 方法 ， 在 该 方法 中 做 一 些 初始 化 的 操作 ， 例 如 通过 
setContentView 设置 布局 资源 、 查 找 布局 文件 中 的 控件 等 。 


@ onStart: 此 方法 回调 时 表示 Activity 正在 启动 。 此 时 Activity 已 处 于 可 见 状态 ， 只 是 还 没有 在 
前 台 显 示 ， 也 无 法 与 用 户 进行 交互 。 
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onResume: 此 方法 回调 时 说 明 Activity 已 经 在 前 台 可 见 、 可 以 跟 用 户 进行 交互 了 。 
onPause: 此 方法 调用 时 表示 Activity 正在 停止 。 
onStop: 表示 Activity 即将 停止 ， 此 时 Activity 不 可 见 ， 仅 在 后 台 运 行 。 
onRestart: 表示 Activity 正在 重启 ， 当 Activity 由 不 可 见 变 为 可 见 状态 时 ， 该 方法 被 回调 。 一 
般 是 用 户 打 开 了 一 个 新 的 Activity， 当 前 的 Activity 会 被 暂停 ( onPause 和 onStop 被 执行 了 )， 
接着 又 回 到 当前 Activity 页 面 ，onRestart 方法 就 会 被 回调 。 

® ”onDestroy: 此 方法 调用 时 表示 Activity 即将 被 销毁 ， 是 Activity 生命 周期 的 最 后 一 个 方法 。 

在 这 个 方法 中 可 以 做 一 些 回收 工作 和 最 终 的 资源 释放 ( 例如 广播 、Service 等 )。 

接 下 来 通过 代码 来 验证 一 下 。 在 MainActivity 中 重 写 图 3-1 正方 形 中 的 所 有 方法 , 并 且 在 每 个 
方法 中 打印 Log。 运行 之 后 ， 看 这 些 方 法 都 在 什么 情况 下 调用 。 重 写生 命 周期 中 的 方法 第 一 行 要 调 
用 super。 


public class MainActivity extends AppCompatActivityt{ 
Private String TAG="ansen"; 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 
Log.i(TAG, "onCreate"); 

} 


@Override 

protected void onstart() { 
super.onstart (); 
Log.i(TAG, "onStart") 7 

} 


@Override 

protected void onResume() { 
super.onResume (); 
Log.i (TAG, "onResume"); 

} 


@Override 

protected void onPause() { 
super.onPause(); 
Log.i(TAG, "onPause"); 

} 


@Override 

Protected void onStop () { 
Super .onStop () 7 
Log.i(TAG, "onStop") 

} 


@Override 

Protected void onDestroy() { 
super.onDestroy(); 
Log.i(TAG, "onDestroy"); 
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} 
@Override 
protected void onRestart() { 
super.onRestart (); 
Log.i(TAG, "onRestart") 7 
} 
} 
直接 运行 代码 ， 打 印 log 如 下 ， 回 调 方法 过 程 是 onCreate 一 onStart 一 onResume。 
04-26 20:45:37.655 8655-8655/com.ansen.activity I/ansen: onCreate 
04-26 20:45:37.657 8655-8655/com.ansen.activity I/ansen: onStart 
04-26 20:45:37.662 8655-8655/com.ansen.activity I/ansen: onResume 
在 当前 页 面 按 住 系统 Home 键 ， 这 时 会 回 到 首页 。 打 印 log 如 下 ， 回 调 方 法 过 程 是 onPause 一 
onStop。 


04-26 20:49:23.549 8655-8655/com.ansen.activity I/ansen: onPause 
04-26 20:49:23.585 8655-8655/com.ansen.activity I/ansen: onStoPp 


从 手机 首页 找到 App， 点 击 之 后 进入 App 首页 ， 重新 显示 MainActivity。 打 印 log 如 下 ,回调 





方法 过 程 是 onRestart 一 onStart 一 onResume。 


04-26 20:51:09.737 8655-8655/com.ansen.activity I/ansen: onRestart 
04-26 20:51:09.748 8655-8655/com.ansen.activity I/ansen: onStart 
04-26 20:51:09.751 8655-8655/com.ansen.activity I/ansen: onResume 


按 住 系统 返回 键 回 到 手机 首页 ， 这 时 当前 Activity 销毁 ， 应 用 程序 退出 。 打 印 log 如 下 ， 回 调 


方法 过 程 是 onPause 一 onStop 一 onDestroy。 


04-26 20:52:39.398 8655-8655/com.ansen.activity I/ansen: onPause 
04-26 20:52:39.746 8655-8655/com.ansen.activity I/ansen: onStop 
04-26 20:52:39.747 8655-8655/com.ansen.activity I/ansen: onDestroy 


通过 以 上 的 log 分 析 再 回头 看 看 图 3-1， 相 信 读 者 对 Activity 的 生命 周期 有 了 更 深刻 的 认识 。 


3.1.2 ”启动 Activity 的 两 种 方式 


启动 一 个 Activity， 有 显 式 启动 和 隐 式 启动 两 种 方式 。 

@ ” 显 式 Intent: 一 般 用 于 启动 同一 个 应 用 中 的 Activity， 效 率 高 。 

@ 隐 式 Intent: 一 般 用 于 启动 不 同 应 用 中 的 Activity， 通 过 Intent Filter 来 实现 。 因 为 没有 明确 指 
出 目标 Activity， 所 以 效率 相对 低 一 些 。 


1. 显 式 Intent 启动 Activity 


新 建 一 个 SecondActivity 类 继承 AppCompatActivity: 


Public class SecondActivity extends AppCompatActivity { 
@Override 
Protected void onCreate (Bundle savedInstanceState){ 
Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity second); 
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} 
如 果 写 新 的 Activity， 一 定 要 在 AndroidManifest.xml 中 注册 : 


<activity android:name="com.ansen.activity.SecondActivity"/> 


然后 在 MainActivity 中 启动 我 们 刚 创 建 的 SecondActivity: 


Intent intent=new Intent (this,SecondActivity.class); 
startActivity (intent); 


2. 隐 式 Intent 启动 Activity 


新 建 一 个 ThreeActivity 类 继承 AppCompatActivity: 


public class ThreeActivity extends AppCompatActivity { 
@Override 
Protected void onCreate (Bundle savedInstanceState) 1{ 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity three); 


} 
同样 需要 在 Activity 中 注册 ， 因 为 ThreeActivity 是 隐 式 启动 ， 所 以 需要 增加 intent-filter 过 滤 
器 。 在 过 滤器 中 增加 标签 ， 指 定 name 的 值 〈 是 一 个 字符 串 ) ， 隐 式 启 动 时 就 是 根据 这 个 值 来 找到 
Activity。 标 签 是 固定 的 写法 。 
<activity android:name="com.ansen.activity.ThreeActivity" > 
<intent-filter> 
<action android:name="com.ansen.activity.ThreeActivity"/> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 
在 MainActivity 中 隐 式 启动 ThreeActivity, 用 上 一 步 标签 name 的 值 给 Intent 的 构造 方法 即 可 。 


Intent threeIntent=new Intent ("com.ansen.activity.ThreeActivity"); 
startActivity (threeIntent) 7 


3.1.3 在 Activity 中 使 用 Toast 


Toast 是 Android 系统 的 一 种 提示 方式 ， 显 示 某 一 段 话 来 提示 用 户 ， 显 示 一 段 时 间 自 动 消息 ， 
不 占用 屏幕 空间 。 

Toast 与 其 他 组 件 一 样 , 都 属于 UI 界面 中 的 内 容 ， 因 此 在 子 线程 中 无 法 使 用 Toast 弹出 提示 内 
容 。 如 果 强 行 在 子 线程 中 添加 Toast， 就 会 导致 错误 。 

Toast 使 用 起 来 很 简单 ， 官 方 SDK 已 经 帮助 封装 好 了 ， 只 需要 一 行 代码 即 可 。 最 简单 的 写法 
如 下 : 

Toast .makeText (this, "提示 ", Toast .LENGTH_LONG) . show (); 

调用 Toast 类 的 makeText 静态 方法 , 传 入 三 个 参数 : Context、 提示 内 容 、 显 示 时 长 。 makeText 
方法 会 返回 Toast 对 象 ， 调 用 show 方法 显示 出 来 。 运 行 效果 如 图 3-2 所 示 。 
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图 3-2 Toast 显示 效果 


系统 Toast 基本 都 是 半 透 明 背 景 、 黑 色 的 字体 ， 不 太 好 看 ， 并 且 不 同 版 本 的 Android 操作 系统 
显示 的 效果 还 不 一 样 。 不 像 iOS 开发 ， 能 够 统一 规范 管理 。Google 早 给 我 们 考虑 到 了 ， 只 需要 调 
用 Toast 对 象 的 setView 方法 就 能 设置 显示 我 们 自 定义 的 View。 

我 们 自己 封装 一 个 CustomToast 类 ， 通 过 单 例 模式 (学 过 Java 的 读者 对 这 个 设计 模式 应 该 都 
很 熟悉 ， 不 知道 的 请 求助 于 网 页 搜索 ) 获取 这 个 类 的 对 象 。 


public class CustomToast { 
Private static CustomToast  _ instance = null; 
Private Toast toast = null; 


Private final int MARGIN DP = 50; 


Private CustomToast () { 


Public static CustomToast getInstance() { 
if ( instance == null) { 
instance = new CustomToast () 7 
} 
return instance; 


Public void cancel() { 
if (toast != null) { 
toast.cancel () 7 
toast = null; 


} 


Public void showToastCustom (Context ctx, String msg, int gravity) { 
showToastCustom(ctx, msg,R.layout.toast msg, R.id.txt toast message, 
gravity); 
Ek 
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显示 自 定义 布局 

eparam ctx 上 下 文 对 象 

eparam msg 显示 内 容 

eparam layoutResId 布局 文件 资源 id 

eparam txtResId 布局 文件 中 TextView 控件 id 
* Q@param gravity 显示 位 置 


public void showToastCustom(Context ctx, String msg, int layoutResId, int 
txtResId, int gravity) { 
cancel () ;// 显 示 之 前 取消 上 次 显示 ， 这 样 每 次 都 能 显示 最 新 的 
EE 
if (TextUtils.isEmpty(msg)) { 
return; 
’ 
View layout = View.inflate(ctx, layoutResId, null); 
TextView txtMsg = layout.findViewById (txtResId); 
txtMsg.setText (msg); 
toast = new Toast (ctx); 
toast .setDuration (Toast .LENGTH SHORT); 
if (gravity == Gravity.TOP) { 
int marginVertical = (int) dip2px (ctx, MARGIN DP); 
toast .setGravity (gravity, 0,marginVertical); 
} else if (gravity == Gravity.BOTTOM) { 
int marginVertical = (int) dip2px (ctx, MARGIN DP); 
toast .setGravity (gravity, 0,marginVertical); 
eo 
toast .setGravity (gravity, 0, 0); 
} 
toast.setView (layout); 
toast.show(); 
} catch (Exception e) { 
e.PrintStackTrace (); 
让 
直 


六 大 

* dp 转 px 

* @param context 

* @param dpValue 

* @return 

A 

Public static float dip2px (Context context, float dpValue) { 
final float scale = context.getResources() .getDisplayMetrics() .density; 
float result = dpValue * scale + 0.5f; 
return result; 


getInstance: 通过 这 个 方法 获取 对 象 。 

cancel: 取消 显示 。 

showToastCustom: 有 两 个 方法 名 一 样 的 方法 ， 只 是 参数 不 一 样 ， 这 是 方法 重 载 ， 我 们 主要 查 
看 下 面 那 个 参数 多 的 方法 。 这 个 方法 中 第 一 行 代码 调用 cancel 方法 ， 如 果 之 前 已 有 显示 ， 那 
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么 Toast 就 取消 之 前 的 ; 如 果 显示 内 容 为 室 ， 则 直接 返回 ， 调 用 Viewinflate 方法 将 布局 资源 
id 变 成 View 对 象 , 从 布局 文件 中 查找 TextView, 将 显示 内 容 赋值 给 TextView。 新建 一 个 Toast 
对 象 ， 设置 显示 时 间 ， 判 断 Toast 显示 位 置 ， 如 果 显 示 在 顶部 或 者 底部 ， 则 需要 设置 yOflset 
参数 ,不 然 Toast 紧 挨 着 顶部 或 者 底部 效果 肯定 不 好 看 .调用 Toast 对象 的 setView 方法 将 View 
赋值 进去 ， 最 后 调用 show 方法 进行 显示 。 

edip2px: 将 dip 的 值 转换 成 px， 根据 不 同 屏幕 的 分 辨 率 转 成 px 的 值 是 不 一 样 的 ， 这 样 做 的 目 
的 是 为 了 兼容 不 同 的 分 辨 率 。 


Toast 显示 的 布局 文件 : toast_msg.xml。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/layout custom toast" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:background="@drawable/toast bg" 
android:orientation="vertical"> 


<TextView 

android:id="@+id/txt toast message" 
:layout margin="5dp" 
:layout width="match parent" 
:layout height="wrap content" 
:paddingLeft="10dip" 
:paddingRight="10dp" 
:text="" 

android:textColor="#FFFFFF"/> 

</LinearLayout> 










最 外 层 是 LinearLayout， 里 面 一 个 TextView 用 来 显示 内 容 。 最 外 层 的 LinearLayout 设置 了 
background 属性 ， 指 向 了 一 个 shape 文件 toast_bg.xml， 内 容 如 下 : 


<?xml Version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 


<gradient 
android:angle="-90" 
android:endColor="@color/colorAccent" 
android:startColor="@color/mainColor" /> 


<corners android:radius="5dip" /> 
<stroke 
android:width="ldip" 
android:color="#EEEEEE" /> 
</shape> 


在 shape 文件 中 给 Toast 的 View 设置 渐变 色 、 弧 度 和 边框 。 
这 样 CustomToast 类 就 封装 好 了 ， 接 下 来 在 MainActivity 中 进行 调用 ， 查 看 效果 。 
调用 自 定义 Toast 显示 在 Activity 顶部， 如 图 3-3 所 示 。 


CustomToast .getInstance () .showToastCustom (MainActivity.this, "显示 顶部 "， 
Gravity.TOP); 
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调用 自 定义 Toast 显示 在 Activity 中 间 ， 效 果 如 图 3-4 所 示 。 


CustomToast .getInstance () .showToastCustom(MainRctivity.thisv" 显 示 中 间 "， 
Gravity.CENTER) 7 


调用 自 定 义 Toast 显示 在 Activity 底部 ， 效 果 如 图 3-5 所 示 。 


CustomToast .getInstance () .showToastCustom(MainActivity.this," 显示 底部 "， 
Gravity.BOTTOM); 


自 定义 的 Toast 比 Android 自 带 的 Toast 好 看 , 并 且 想 显示 什么 效果 时 只 需 修改 布局 文件 即 可 。 
这 样 产品 经 理 更 改 需求 时 ， 程 序 员 就 不 用 慌 了 。 


Toast 提 示 Toast 提 示 

Toast 自 只 义 布局 显示 顶部 Toast 自 定义 布局 星 示 顶 部 Toast 自 定义 布局 显示 顶部 
Toast 自 定义 布局 显示 中 间 Toast 自 定义 布局 显示 中 间 Toast 自 定义 布局 显示 中 间 
Toaat 自 定义 布局 显示 底部 Toast 自 定义 布局 旦 示 底部 Toast 自 定义 布局 显示 底部 











3-3 ” 自 定义 Toast 显示 项 部 图 3-4 自 定义 Toast 显示 中 间 图 3-5” 自 定义 Toast 显示 底部 


3.1.4 ”Activity 启动 与 退出 动画 


在 App 中 打开 一 个 新 的 页 面 时 ，Activity 之 间 的 切换 是 不 可 避免 的 ， 那么 怎么 才能 让 Acitivity 
的 切换 更 优雅 昵 ? 在 Android 中 提供 了 一 个 方法 来 解决 这 个 问题 ， 即 Activity 的 
overridePendingTransition (enterAnim，exitAnim) 方法 ， 它 有 两 个 参数 。 

@ 参数 enterAnim 表示 的 是 从 Activity A 跳 转 到 Activity B， 进 入 B 时 的 动画 效果 。 

”参数 exitAnim 表示 的 是 从 Activity A 跳 转 到 Activity B， 离 开 A 时 的 动画 效果 。 

使 用 这 个 方法 有 两 个 注意 事项 : 

@ overridePendingTransition 方法 需要 在 startAtivity 方法 或 者 finish 方法 调用 之 后 立即 执行 。 

”车 进 入 B 或 者 离开 A 时 不 需要 动画 效果 ， 则 可 以 传 值 为 0。 

Android 本 身 也 自 带 了 一 些 切 换 Activity 的 动画 xml 文件 , 例如 从 Activity A 跳 转 到 Activity B 
时 ，Activity B 从 屏幕 左边 切入 。 


Intent intent = new Intent (MainActivity.this, SecondActivity.class); 
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StartRActivity(intent) 7 

//Secondactivity 从 屏幕 左边 滑 进来 ， 使 用 自 带 的 动画 xml 

OverridePendingTransition (android.R.anim.slidqe in left,android.R.anim.slid 
e out right); 


当然 ， 官 方 自 带 的 动画 效果 总 是 有 限 的 ，Google 也 不 可 能 在 SDK 中 集成 很 多 的 Activity 切换 
动画 效果 ， 这 时 就 需要 写 动画 xml 文件 了 ， 例 如 实现 iPhone 手机 的 进入 和 退出 时 的 效果 。 
首先 在 res 文件 夹 下 新 建 anim 文件 夹 ， 在 anim 文件 夹 下 新 建 zoomin.xml 文件 ， 有 具体 内 容 如 
> 
<?xml Version="1.0" encoding="utf-8"?> 
<set xmlns:android="http://schemas.android.com/apk/res/android" 
android:interpolator="@android:anim/decelerate interpolator"> 
<scale 
android:duration="@android:integer/config mediumAnimTime" 
android:fromXScale="2.0" 
android:fromYScale="2.0" 
android:pivotX="50%p" 
android:pivotY="50%p" 
android:toXScale="1.0" 
android:toYScale="1.0"/> 
</set> 


其 中 有 一 个 scale 标签 ， 这 个 标签 起 到 缩放 效果 。 顺 便 解释 一 下 scale 标签 中 各 个 属性 的 作用 。 

@ android:duration: 动画 持续 时 间 ， 以 毫秒 为 单位 。 

e@ android:ffromXScale: 起 始 X 尺寸 比例 。 

e@ android:ffromYScale: 起 始 Y 尺寸 比例 。 

@ android:pivotX: 缩放 起 点 义 轴 坐标 , 取 值 可 以 是 数值 (50) 百分数 (50%)、 百分数 p(50%p )， 
当 取 值 为 数值 时 ， 缩 放 起 点 为 View 左上 角 坐 标 加 上 具体 数值 像素 ; 当 取 值 为 百分数 时 ， 表 
示 在 当前 View 左上 角 坐 标 加 上 View 宽度 的 具体 百分比 ; 当 取 值 为 百分数 p 时 , 表示 在 View 
左上 角 坐 标 加 上 父 控 件 宽度 的 具体 百分比 。 
android:pivotY: 同 android:pivotX。 
android:toXScale: 最 终 义 尺寸 比例 。 
android:toYScale: 最 终 Y 尺寸 比例 。 


在 anim 文件 夹 下 继续 新 建 一 个 文件 zoomout.xml， 内 容 如 下 : 


<?xml Version="1.0" encoding="utf-8"?> 

<set xmlns:android="http://schemas.android.com/apk/res/android" 
android:interpolator="@android:anim/decelerate interpolator" 
android:zAdjustment="top"> 


<scale 

android:duration="@android:integer/config mediumAnimTime" 
android:fromxXScale="1.0" 

android:fromYScale="1.0" 

android:pivotX="50%p" 

android:pivotY="50%p" 

android:toXScale=".5" 

android:toYScale=".5" /> 


第 3 章 Android 四 大 组 件 | 149 





<alpha 
android:duration="@android:integer/config mediumAnimTime" 
android:fromAlpha="1.0" 
android:toAlpha="0"/> 
</set> 
除了 scale 标签 之 外 ， 还 增加 了 一 个 alpha 标签 ， 这 个 标签 用 于 改变 透明 图 。 下 面 解释 alpha 
标签 各 个 属性 的 作用 : 
@ android:duration: 动画 持续 时 间 ， 以 毫秒 为 单位 。 
e@ android:ffromAlpha: 动画 开始 的 透明 度 ， 取 值 为 0.0~1.0，0.0 表示 完全 透明 ，1.0 表示 保持 原 
有 状态 不 变 。 
@ 动画 最 终 的 透明 度 取 值 和 android:fromAlpha 一 样 。 


两 个 动画 xml 文件 写 完了 ， 开 启 一 个 新 的 Activity 时 进行 调用 : 

intent = new Intent (MainActivity.this, ThreeActivity.class); 

startActivity (intent); 

overridePendingTransition(R.anim.zoomin,R.anim.zoomout); 

overridePendingTransition 方法 第 一 次 参数 传 入 的 是 zoomin， 第 二 个 参数 传 入 的 是 zoomout， 
也 就 是 从 MainActivity 跳 转 到 ThreeActivity 时 ，ThreeActivity 进行 放大 。MainActivity 缩小 并 且 改 
变 透 明度 为 0， 就 是 不 可 见 。 这 样 切换 页 面 就 是 类 似 iPhone 的 进入 和 退出 时 的 效果 。 

运行 代码 效果 如 图 3-6 与 图 3-7 所 示 。 图 3-6 是 Activity 切换 时 动画 运行 时 ， 图 3-7 是 Activity 
切换 完成 ， 也 就 是 动画 结束 之 后 的 效果 。 如 果 想 看 清 切 换 动画 的 过 程 ， 则 将 动画 时 间 延 长 一 些 ， 例 
如 改 成 5000 毫秒 。 





以 下 天 Macroid 58 卫 本 以 司 才 有 鸣 ACtity 这 
半 二 下 





ThreeActivity 


ThreeActivity 





3-6 ”Activity 切换 中 动画 运行 过 程 图 3-7 Activity 切换 动画 结束 
Android 5.0 以 后 Activity 之 间 切 换 动画 
上 面 讲解 通过 overridePendingTransition 方法 ， 基 本 上 可 以 满足 日 常 中 对 Activity 跳 转 动画 的 
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需求 了 。 不 过 ,， 炫 酷 的 MD (Material Design) 风格 出 来 之 后 ，overridePendingTransition 这 种 老 旧 、 
生硬 的 方式 不 能 适合 MD (Material Design) 风格 的 App 了 。 

好 在 Google 在 新 的 SDK 中 提供 了 另 一 种 Activity 的 过 渡 动 画 一 一 ActivityOptions， 并 且 提 供 
了 兼容 包 ActivityOptionsCompat。ActivityOptionsCompat 是 一 个 静态 类 ， 提 供 了 相应 的 Activity 跳 
转动 画 效果 ， 通 过 其 可 以 实现 不 少 炫 酷 的 动画 效果 。 

内 置 的 Activity 之 间 切 换 动 画 有 以 下 几 种 : 
Explode 效果 。 
Slide 效果 。 
Fade 效果 。 
Shared Element 效果 。 


(1 ) Explode 效果 
设置 Explode 爆炸 效果 ， 从 场景 的 中 心 移入 或 移出 。 实 现 起 来 也 很 简单 : 在 项 目的 res 文件 夹 
下 新 建 transition 文件 夹 ， 并 在 transition 文件 夹 下 新 建 explode.xml 文件 ， 内 容 如 下 : 


<explode xmlns:android="http://schemas.android.com/apk/res/android" 
android:duration="1000"/> 


最 外 层 是 explode 标签 ， 仅 android:duration 一 个 属性 ， 该 属性 用 来 设置 动画 的 执行 时 间 。 
新 建 ExplodeActivity 类 ， 继 承 AppCompatActivity 。 


Public class ExplodeActivity extends AppCompatActivity { 
@Override 
Protected void onCreate(Bundle savedInstanceState) { 
super.onCreate (SavedInstanceState) 7 


if (Build.VERSION.SDK INT>Build.VERSION CODES.KITKAT WATCH) { 
// 版 本 号 大 于 4.4 


Transition explode = TransitionInflater.from(this) . 


inflateTransition (R.transition.explode) 
getWindow () .setEnterTransition (explode) ;// 第 一 次 进入 时 动画 


} 
setContentView(R.layout.activity explode); 


findViewById(R.id.11 root) .setOnClickListener (new 
View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
finish(); 


]) 7 


主要 了 解 setContentView 前 面 几 行 代码 ， 首 先 判断 版 本 号 是 不 是 5.0 以 上 ， 然 后 用 
TransitionInflater 类 初始 化 写 好 的 xml 文件 ， 返 回 一 个 Transition 对 象 ， 调 用 Window 的 
setEnterTransition 方法 设置 进去 。 


启动 带 爆 炸 效果 的 Activity ， 跟 我 们 之 前 启动 Activity 的 方式 稍微 有 点 区 别 。 例 如 ， 启 动 
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ExplodeActivity， 修 改 之 后 如 下 : 


intent = new Intent (MainActivity.this,ExplodeActivity.class); 
startActivity (intent,ActivityOptions. 
makeSceneTransitionAnimation (MainActivity.this) .toBundle()); 


startActivity 方法 需要 传 入 两 个 参数 ， 第 一 个 参数 是 intent 对 象 ， 第 二 个 参数 是 Bundle 对 象 ， 
用 ActivityOptions 类 的 makeSceneTransitionAnimation 方法 创建 ActivityOptions 对 象 ， 调 用 
ActivityOptions 对 象 的 tbBundle 方法 ， 将 返回 的 Bundle 对 象 传 入 进去 。 

运行 代码 ， 效 果 如 图 3-8、 图 3-9、 图 3-10 所 示 。 





一 一 


ActivityAnimation 


ActivityAnimation 


ExplodeActivity 
ExplodeActivity 


ExplodeActivity 





图 3-8 ”Explode 动画 运行 过 程 1 3-9 ”Explode 动画 运行 过 程 2 图 3-10 ”Explode 动画 结束 


(2 ) Slide 效果 
Slide 使 用 与 Explode 相同 的 步骤 ， 在 res/transition 文件 夹 下 新 建 slide.xml， 内 容 如 下 : 


<slide xmlns:android="http://schemas.android.com/apk/res/android" 


android:interpolator="@android:interpolator/decelerate cubic" 
android:slideEdge="end" 
android:duration="1000"/> 


android:interpolators 属性 设置 插值 器 ， 就 是 用 来 控制 滑动 速度 。 这 里 使 用 SDK 自 带 的 
decelerate_cubic. 

android:slideEdge 有 4 个 值 ， 表 示 不 同 的 方向 滑动 效果 : end 表示 右 侧 ，start 表示 左 侧 ，top 
表示 顶部 ，bottom 表示 底部 。 

android:duration 设置 动画 执行 时 间 。 


如 果 不 希望 顶部 的 状态 栏 一 起 执行 动画 , 可 以 在 xml 中 根据 控件 id 进行 忽略 ,修改 的 slide.xml 


如 下 : 


<slide xmlns:android="http://schemas.android.com/apk/res/android" 


android:duration="1000" 
android:interpolator="@android:interpolator/decelerate cubic" 
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android:slideEdge="end"> 
<targets> 
<target android:excludeId="@android:id/statusBarBackground" /> 
</targets> 
</slide> 
从 xml 中 可 以 看 到 在 slide 标签 中 增加 了 targets 标签 ， 在 targets 标签 中 增加 target 标签 ， 设 置 
android:excludeld 属性 ， 属 性 的 值 就 是 忽略 的 控件 id。 如 果 需 要 忽略 多 个 View， 则 一 直 增 加 target 
标签 
运行 代码 ， 其 效果 如 图 3-11 与 图 3-12 所 示 。 


Q 10:34 





ActivityAnimati 


ActivityAnimation 








图 3-11 slide 动画 运行 过 程 3-12 slide 动画 结束 


(3 ) Fade 效果 

Fade 淡化 效果 使 用 的 方法 与 前 面 两 种 效果 类 似 。 新 建 fade.xml 文件 ， 内 容 如 下 : 

<fade xmlns:android="http://schemas .android.com/apk/res/android" 

android:duration="1000" /> 

Fade 效果 就 是 将 View 从 无 到 有 , 将 透明 度 从 0 慢 慢 变 成 1 的 过 程 。 这 里 就 不 贴 效 果 图 了 ,大 
家 自己 运行 源码 查看 效果 。 

(4 ) Shared Element 效果 

Shared Element 共享 元 素 效果 与 前 面 几 种 效果 不 同 ,共享 元 素 就 是 从 Activity A 过 渡 到 Activity 
B， 可 以 指定 元 素 过 渡 ， 给 View 增加 android:transitionName 属性 。 先 查看 运行 效果 图 ， 如 图 3-13、 
图 3-14、 图 3-15 所 示 。 

从 效果 图 可 以 看 到 Activity 切换 过 程 中 ， 顶 部 的 两 个 View 慢 慢 移动 到 底部 ， 并 且 在 移动 的 过 
程 中 会 改变 View 的 宽度 。 有 了 这 种 切换 动画 ， 用 户 可 能 感觉 不 到 开启 了 一 个 新 的 界面 ， 接 下 来 看 
看 是 如 何 实现 的 。 
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1234 1234 


ActivityAnimation 


ActivityAnimation ActivityAnimation 





点 击 我 关闭 当前 界面 











3-13 ”Shared Element 动画 运行 前 图 3-14 ”Shared Element 动画 运行 中 图 3-15 ”Shared Element 动 画 运行 结束 


首先 查看 Activity A 的 布局 文件 ， 也 就 是 动画 开始 前 显示 的 界面 。 这 个 文件 很 简单 ， 即 一 个 
View 和 TextView， 需 要 注意 的 是 给 这 两 个 View 设置 了 android:transitionName 属性 ， 属 性 的 值 是 
-个 字符 串 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match Parent" 
android:layout height="match parent" 
android:id="@+id/rl root" 
android:orientation="vertical" 
android:padding="10dp"> 





:id="@+id/view share _ one" 
android:layout width="100dp" 
android:layout height="50dp" 
android:background="@color/primary light" 
android:transitionName="share one"/> 


<TextView 
android:id="@+id/view share two" 
android:layout width="100dp" 
android:layout height="50dp" 
android:background="@color/colorPrimary" 
android:text=" 点 击 我 " 
android:gravity="center" 
android:textColor="#FFFFFF" 
android:transitionName="share two"/> 
</LinearLayout> 


SharedElementActivity.java( 第 一 个 Activity) 的 内 容 如 下 : 


Public class SharedElementActivity extends AppCompatActivity implements 
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View.OnClickListener{ 
Private View viewShareOne; 
Private TextView viewShareTwo; 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity shared element); 


viewShareOne=findViewById(R.id.view share one); 
viewShareTwo=findViewById(R.id.view share two); 


findViewById(R.id.rl root) .setOnClickListener(this) 
viewShareTwo.setOnClickListener (this); 


| 





@Override 
Public void onClick(View view) { 
if(view.getId()==R.id.rl root){ 
finish() 


}else if(view.getId()==R.id.view share two) {// 开 启 过 渡 效 果 
Intent intent = new Intent (this, SecondShareElemActivity.class); 


Pair onePair = new Pair<> (viewShareOne, 
ViewCompat .getTransitionName (viewShareOne)); 

Pair twoPair = new Pair<> (viewShareTwo, 
ViewCompat .getTransitionName (viewShareTwo)); 


ActivityOptionsCompat transitionActivityOptions = 
ActivityOptionsCompat .makeSceneTransitionAnimation( 
this, onePair, twoPair); 
ActivityCompat.startActivity (this,intent, 
transitionActivityOptions.toBundle()); 


} 


这 里 需要 注意 的 是 , 将 两 个 View 对 象 构建 成 两 个 Pair 对 象 , 通过 ActivityOptionsCompat 类 的 
makeSceneTransitionAnimation 静态 方法 得 到 ActivityOptionsCompat 对 象 ， 这 个 方法 的 第 二 个 参数 
是 一 个 数组 ， 可 以 传 入 多 个 Pair。 最 后 调用 ActivityCompat.startActivity 开启 Activity 。 

activity_second_share_elem.xml 是 Activity B 显示 的 布局 文件 ， 最 外 层 是 RelativeLayout， 第 一 
个 View 是 Button, 底部 还 有 一 个 LinearLayout，LinearLayout 中 的 两 个 View 与 Activity A 的 View 
差不多 ， 改 变 了 控件 宽度 。 需 要 注意 的 是 ， 这 两 个 View 同样 设置 了 android:transitionName 属性 ， 
这 个 值 需要 与 Activity A 显示 的 布局 文件 中 的 值 进行 对 应 ， 就 是 通过 这 个 属性 的 值 来 判断 从 哪个 
View 过 渡 到 哪个 View。 

<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:id="@+id/rl1 root"™ 
android:layout width="match Parent" 


android:layout height="match parent" 
android:padding="10dp"> 
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<Button 
android:id="@+id/btn close" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text=" 点 击 我 关闭 当前 界面 " 
android:layout centerHorizonta 
android:layout marginTop="100dp" 
android:textColor="@color/accent" 
android:textSize="25sp"/> 











"true"™ 


<LinearLayout 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:orientation="vertical"> 


<View 
android:layout width="match parent" 
android:layout height="100dp" 
android:background="@color/primary light" 
android:transitionName="share one" /> 


<TextView 
android:layout width="match parent" 
android:layout height="100dp" 
android:background="@color/colorPrimary" 
android:gravity="center" 
android:textColor="#FFFFFF™" 
android:transitionName="share two" /> 
</LinearLayout> 
</RelativeLayout> 


SecondShareElemActivity.java( 第 二 个 Activity) 文件 的 Activity 代码 很 少 ， 需 要 注意 的 是 ， 点 
击 按钮 时 调用 的 是 finishAfterTransition 来 关闭 当前 的 Activity， 这 样 的 目的 是 产生 一 个 退出 动画 效 


果 。 


Public class SecondShareElemActivity extends AppCompatActivity { 


@Override 
Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 


setContentView(R.layout.activity second share elem) 


findViewById(R.id.btn close) .setOnClickListener (new 
View.OnClickListener() { 
@Override 
public void onClick(View v) { 
finishAfterTransition();// 进 行 退出 动画 
0 
$y 


findViewById(R.id.rl root).setOnClickListener(new 
View.OnClickListener() { 
@Overrigde 
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public void onClick(View view) { 
finish(); 


3.1.5 ”Activity 销毁 


每 一 个 Activity 都 有 自己 的 生命 周期 ， 打开 了 就 要 及 时 关闭 ， 从 而 释放 内 存 ， 也 可 以 避免 程序 
出 现 未 知 错误 。 

要 关闭 当前 的 Activity， 直 接 调用 finish 方法 即 可 : 

finish(); 

如 果 当 前 打开 了 多 个 Activity, 这 时 想 退 出 程序 怎么 办 呢 ? finish 只 能 退出 当前 的 一 个 Activity。 
还 有 两 种 方案 ， 能 够 直接 终止 程序 进程 。 

方法 一 : 

System.exit (0) ;// 使 用 系统 的 方法 ， 强 制 退出 ， 终 止 程序 

方法 二 : 

android.os.Process.killProcess (android.os.Process.myPid() ) ;// 直 接 终止 当前 进程 

这 两 个 方法 确实 能 把 程序 进程 终止 ， 但 是 会 重新 启动 App， 并 重新 创建 一 个 新 的 进程 。 因 为 
Android 系统 认为 App 是 被 意外 终止 的 《如 内 存 不 足 ) ， 系 统 底层 有 监听 服务 ，App 被 意外 终止 会 
自动 重启 。 

销毁 所 有 的 Activity 

当 打 开 多 个 Activity 时 ， 系 统 提 供销 毁 所 有 Activity 的 方法 都 会 有 一 些 问 题 ， 于 是 我 们 只 能 自 
己 想 办 法 去 实现 ， 解 决 方案 就 是 把 开启 的 Activity 保存 到 栈 中 ， 退 出 软件 时 把 栈 中 所 有 的 Activity 
一 一 销毁 。 

首先 新 建 一 个 MyApplication 类 ， 继 承 系统 的 Application 类 ， 其 中 增加 几 个 方法 ， 每 个 方法 都 
有 注释 ， 就 不 解释 了 。 重 点 了 解 finishAllActivity 方法 ， 因 为 每 次 打开 一 个 新 的 Activity 时 ， 就 会 
把 Activity 保存 到 栈 中 ， 因 此 退出 程序 时 只 需要 将 栈 中 的 所 有 Activity 退出 来 ， 调 用 finish 方法 。 

Public class MyApplication extends Applicationt{ 


private static Stack<Activity> activitystack;//activity 栈 


/** 
* 添加 Activity 到 堆栈 
ey 
Public void addActivity(Activity activity) { 
if (activityStack == null) { 
activityStack = new Stack<>(); 
. 


if(!activityStack.contains (activity) ){ 
Log.i("ansen", "添加 Activity:"+tactivity.getLocalClassName ()); 


第 3 章 Android 四 大 组 件 | 157 





} 


activityStack.add (activity); 


} 


J/ 
* 获取 当前 Activity 堆 栈 中 最 后 一 个 压 入 的 》 
让 
public Activity currentActivity() { 
Activity activity = activityStack.lastElement (); 
return activity; 


} 


public void removeActivity (Activity activity) { 
if (activity != null&&activityStack.contains (activity)) { 
Log.i("ansen", "删除 Activity:"+tactivity.getLocalClassName ()); 
activityStack.remove (activity); 


} 


/rx 
* 结束 所 有 Activity 
区 
public void finishAllActivity() { 
for (int i = 0, size = activityStack.size(); i < size; i++) { 
if (null != activityStack.get(i)) { 
activityStack.get (i) .finish(); 
} 
: 
activityStack.clear () 7 
Log.i("ansen", "结束 所 有 Activity")，; 


为 什么 要 将 保存 Activity 的 栈 放 到 Application 中 呢 ? 因为 Application 的 生命 周期 与 应 用 程序 
是 绑 定 的 ， 这 样 能 够 最 大 地 保证 Activity 栈 静 态 变量 不 会 被 系统 回收 。 

因为 重 写 了 Application， 需 要 在 AndroidManifest.xml 文件 的 application 标签 的 android:name 
属性 中 指定 重 写 的 Application 。 


<application 


android:name=" .MyApplication"> 


Er 

合理 地 利用 Activity 的 生命 周期 ，Activity 创建 (onCreate) 与 销毁 (onDestroy) 方法 调用 时 
将 当前 Activity 从 Activity 栈 中 加 入 或 者 移 除 .我 们 不 可 能 每 次 新 建 一 个 Activity 就 去 重 写 onCreate 
和 onDestroy 方法 ， 可 以 封装 一 个 BaseActivity， 所 有 的 Activity 都 继承 自 BaseActivity 即 可 。 然 后 
增加 finishAllActivity 方法 ， 销 毁 所 有 的 Activity。 


Public class BaseActivity extends AppCompatActivity { 





Private MyApplication myApplication; 


@Override 
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Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 


if (myApplication == null) { 
// 得 到 Application 对 象 
myApplication = (MyApplication) getApplication(); 
} 
myApplication.addActivity (this); 
} 


// 销 毁 所 有 Activity 方法 
public void finishAllActivity() { 

myApplication.finishAllActivity();// 调 用 myApplication 销毁 所 有 Rctivity 方 法 
| 


@Override 
protected void onDestroy() { 
super.onDestroy(); 


myApplication.removeActivity (this); 
} 


如 果 想 在 哪个 Activity 退出 程序 时 销毁 所 有 Activity， 只 需要 调用 父 类 BaseActivity 的 
finishAllActivity 方法 即 可 。 


3.1.6 ”Activity 与 Activity 之 间 传 递 数据 


1. 传递 参数 


打开 一 个 新 的 页 面 时 , 可 能 需要 把 一 些 值 传递 过 去 , 称 为 Activity 传递 参数 。 Activity 与 Activity 
之 间 基 本 采用 Intent 传递 参数 ， 是 通过 Bundle 来 实现 的 。 当 调用 intent.putExtra 方法 时 ， 系 统 会 创 
建 一 个 Bundle 对 象 ，Bundle 对 象 有 一 个 ArrayMap， 用 来 存储 数据 。 

上 一 节 通 过 显 式 Intent 启动 了 SecondActivity, 现在 要 传递 一 个 值 给 SecondActivity, 就 要 在 原 
来 的 基础 上 增加 一 行 代码 。 这 里 我 们 传递 了 一 个 字符 串 : 

Intent intent=new Intent (this,SecondActivity.class); 

// 参 数 1:key 参数 2:value 


intent .PutExtra("Parameter","SecondRctivity Parameter") 
startActivity (intent); 


参数 通过 Intent 传递 过 来 了 ， 现 在 需要 在 SecondActivity 中 获取 这 个 值 : 


Public class SecondActivity extends AppCompatActivity { 
@Override 
Protected void onCreate (Bundle savedInstanceState){ 
Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity second) 
String value=getIntent () .getStringExtra("parameter"); 
Log.i("ansen",value); 
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2. Activity 的 传 值 与 回 传 值 
在 MainActivity 启动 FourActivity， 将 通过 startActivityForResult 方法 来 启动 Activity， 并 且 包 
含 第 二 个 参数 requestCode， 接 下 来 会 用 到 。 


Intent fourIntent=new Intent (this,FourActivity.class); 
fourIntent .PutExtra ("parameter","FourActivity Parameter") 
startActivityForResult (fourIntent,REQUEST FOURACTIVITY CODE); 


还 需要 重 写 MainActivity 的 onActivityResult 方法 ,通过 requestCode 来 判断 是 不 是 自己 启动 的 ， 
然后 通过 Intent 获取 回 传 值 。 


@Override 
protected void onActivityResult (int requestCode, int resultCode, Intent data) { 
if(requestCode==REQUEST FOURACTIVITY CODEg&resultCode==RESULT OK){ 
String resultStr=data.getStringExtra("result"); 
Log.i("ansen",resultStr); 
1 
super.onActivityResult (requestCode, resultCode, data); 
} 


接 下 来 查看 FourActivity 是 如 何 写 的 ， 在 onCreate 中 获取 请 求 参 数 ， 重 写 onKeyDown 方法 。 
如 果 按 了 系统 返回 键 ， 通 过 setResult 方法 将 Intent 回 传 给 上 一 个 Activity。 


public class FourActivity extends AppCompatActivity{ 
@Override 
Protected void onCreate (Bundle savedInstanceState){ 
super.onCreate (savedInstanceState) 7 
setContentView(R.layout.activity four); 


String value=getIntent () .getStringExtra ("parameter"); 
Log.i("ansen",value); 
} 


@Override 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 
// 系 统 返回 键 
if (keyCode == KeyEvent .KEYCODE BACK && event.getAction() == 
KeyEvent .ACTION DOWN) { 
Intent intent = new Intent(); 
intent .putExtra("result", "FourActivityResultValue") ;// 封 装 回 传 值 
setResult (RESULT OK, intent) 
finish () ;// 结 束 当前 Activity 
1 
return super.onKeyDown (keyCode, event); 


} 
先 启动 SecondActivity 并 返回 ， 再 启动 FourActivity 并 返回 ， 打 印 Log 截图 ， 如 图 3-16 所 示 。 
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01-17 18:16:41.874 29834-29834/com.ansen.activity I/ansen: onPa 
1.894 29834-29834/com.ansen.activit! 
91-17 18:16:42.394 29834-29834/com.ansen.activity T/ansen: onStop 

91-17 18:16:44.604 29834-29834/com.ansen.activity I/ansen: onRestart 

91-17 18:16:44.604 29834-29834/com.ansen.activity I/ansen: onStart 

91-17 18:16:44,604 29834-29834/com,ansen,activity I/ansen: eneaies 

91-17 18:16;47,134 29834-29834/com,ansen,activity_ILansen: e 
91-17 18: 7.154 29834-29834/com.ansen.activit 
81-17 18:16:47.534 29834-29834/com.ansen.activity 
81-17 18:16:49.234 29834-29834/com.ansen.activity| 
01-17 18:16:49.234 29834-29834/com.ansen.activity 



















ourAct Vit 


一 
nsen: PourAc TITRE 
nse 


parameter 


91-17 18:16:49.234 29834-29834/com.ansen.activity /ne Ee 
01-17 18:16:49.234 29834-29834/com.ansen.activity I/ansen: onResume 





3-16 ”Activity 的 传 值 与 回 传 值 


3.1.7 Activity 的 软 键盘 弹出 方式 


在 AndroidManifest.xml 中 给 Activiy 设置 android:windowSoftInputMode 属性 , 可 以 避免 输入 法 
面板 遮挡 输入 框 的 问题 。 
android:windowSoftInputMode 属性 有 以 下 值 : 


® stateUnspecified: 软 键盘 的 状态 并 没有 指定 ， 系 统 将 选择 一 个 合适 的 状态 或 依赖 于 主题 的 设 
置 。 

@ stateUnchanged: 当 这 个 Activity 出 现时 ， 软 键盘 将 一 直 保 持 在 上 一 个 Activity 中 的 状态 ,无 
论 是 隐藏 还 是 显示 。 
stateHidden: 用 户 选择 Activity 时 ， 软 键盘 总 是 被 隐藏 。 
stateAlwaysHidden: 当 该 Activity 主 窗口 获取 焦点 时 ， 软 键盘 也 总 是 被 隐藏 的 。 
stateVisible: 软 键盘 通常 是 可 见 的 。 
stateAlwaysVisible: 用 户 选 择 Activity 时 ， 软 键盘 总 是 显示 的 状态 。 
adjustUnspecified: 默认 设置 ， 通 常 由 系统 自行 决定 是 隐藏 或 显示 。 
adjustResize: 该 Activity 总 是 调整 屏幕 的 大 小 ， 以 便 留 出 软 键盘 的 空间 。 
adjustPan: 当前 窗口 的 内 容 将 自动 移动 ， 以 便当 前 焦点 从 不 被 键盘 履 盖 和 用 户 总 是 能 够 看 到 
输入 内 容 的 部 分 

可 以 设置 一 个 值 或 者 多 个 值 ， 多 个 用 “|” 分 割 ， 例 如 : 

android:windowSoftInputMode="stateVisibleladjustResize" 

下 面 举 一 个 实例 , 在 布局 文件 的 底部 放置 一 个 EditText 控件 , 软 键盘 弹出 时 的 效果 图 如 图 3-17 

所 示 。 从 效果 图 中 可 以 看 到 软 键 盘 弹 出 时 标题 栏 被 项 上 去 看 不 到 了 。 

这 种 情况 下 就 需要 用 到 android:windowSoftInputMode 了 。 设 置 adjustResize， 软 键盘 弹出 ， 并 
调整 屏幕 的 大 小 。 


<activity android:name=".MainActivity"android:windowSoftInputMode= 
"adjustResize"/> 


运行 代码 ， 从 效果 图 中 可 以 看 到 软 键盘 弹出 ， 标 题 栏 正常 显示 ， 如 图 3-18 所 示 。 


© 0 0 0 0 0。 9。 
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图 3-17 设置 软 键盘 的 弹出 方式 
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图 3-18 ” 软 键盘 弹出 时 标题 正常 显示 


还 有 其 他 的 值 ， 大 家 在 实际 开发 中 根据 需求 进行 设置 即 可 。 


3.1.8 Activity 任务 栈 


Android 任务 栈 有 以 下 特点 : 


@ ”Android 任务 栈 又 称 为 Task， 是 一 个 栈 结 构 ， 具 有 后 进 先 出 的 特性 ， 用 于 存放 我 们 的 Activity 


组 件 。 


@ 我 们 每 次 打开 一 个 新 的 Activity 或 者 销毁 Activity 都 会 在 任务 栈 中 增加 一 条 记录 或 者 减少 一 条 


记录 ， 任 务 栈 保存 Activity 集合 。 
@ 任务 栈 可 以 移动 到 后 台 ， 保 留 每 一 个 Activity 的 状态 ， 


不 丢失 状态 信息 。 


@” 当 把 所 有 任务 栈 中 的 Activity 清除 出 栈 时 ， 任 务 栈 会 被 销毁 ， 程 序 退 出 。 
Android 系统 通过 任务 栈 有 序 地 管理 每 个 Activity, 并 决定 用 哪个 Activity 跟 用 户 交 ] 


务 栈 顶 的 Activity 才能 跟 用 户 进行 交互 。 


有 序 地 给 用 户 列 出 它们 的 任务 ， 并 且 


， 只 有 任 


图 3-19 显示 了 Activity 任务 栈 的 执行 过 程 ， 从 中 可 以 看 到 任务 栈 中 只 有 Activity 1， 然 后 开启 
了 Activity 2， 之 后 又 开启 了 Activity3， 这 时 点 击 系统 返回 键 ， 把 Activity 3 从 任务 栈 中 移 除 ， 于 是 


留 下 了 Activity2 跟 Activity1 。 
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3-19 ”Activity 任务 栈 执行 过 程 





任务 栈 的 缺点 : 

@ 每 开启 一 次 页 面 都 会 在 任务 栈 中 添加 一 个 Activity, 只 有 任务 栈 中 的 Activity 全 部 清除 出 栈 时 ， 
任务 栈 才 会 被 销毁 ， 程 序 才 算 真正 退出 ， 需 要 点 击 多 次 返回 键 才能 退出 程序 。 

@ 每 开启 一 次 页 面 都 会 在 任务 栈 中 添加 一 个 Activity, 还 会 造成 数据 元 余 , 重复 数据 太 多 , 会 导 
致 内 存 溢出 的 问题 (OOM )。 


为 了 解决 任务 栈 的 缺点 ， 我 们 引入 了 启动 模式 。 


.9 Activity 四 种 启动 模式 


启动 模式 (launchMode) 在 多 个 Activity 跳 转 的 过 程 中 扮演 着 重要 的 角色 ， 可 以 决定 是 否 生 成 
Activity 实例 ， 是 否 重用 已 存在 的 Activity 实例 ， 是 否 和 其 他 Activity 实例 共用 一 个 task。 这 
单 介绍 一 下 task 的 概念 。task 是 一 个 具有 栈 结 构 的 对 象 ， 一 个 task 可 以 管理 多 个 Activity， 启 


-个 应 用 ， 也 就 创建 一 个 与 之 对 应 的 task。 


Activity 一 共有 四 种 launchMode: 


standard: 系统 默认 的 启动 模式 ， 即 标准 模式 。 
singleTop: 栈 顶 复 用 模式 。 

singleTask: 栈 内 复 用 模式 。 

singleInstance: 全 局 唯一 模式 。 


怎么 使 用 呢 ? 很 简单 ,只 需要 在 AndroidManifestxml 文件 中 给 activity 设置 android:launchMode 
即 可 。 参 考 如 下 代码 : 


<activity android:name=".MainActivity" android:launchMode="standard"> 
</activity> 

这 四 种 启动 模式 对 应 不 同 的 跳 转 模式 。 接 下 来 详细 介绍 一 下 。 

1. standard (标准 模式 ) 

standard 是 Activity 默认 的 启动 方式 ， 如 果 你 需要 这 种 启动 方式 可 以 不 需要 设置 
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android:launchMode 属性 。 这 种 模式 是 每 次 启动 一 个 Activiy 都 会 创建 一 个 新 的 实例 ， 不 管 这 个 例 
之 前 是 否 存在 ， 这 种 模式 下 ， 谁 启动 了 Activity， 该 Activity 就 属于 启动 该 Activity 的 任务 栈 。 
stardard 启动 模式 效果 如 图 3-20 所 示 。 


back 
startActivity 


| back 
startActivi 
| 


图 3-20 ”stardard 模式 

2. singleTop〈 栈 项 复 用 模式 ) 

这 种 模式 下 ， 如 果 新 打开 的 Activity 已 经 在 栈 顶 了 ， 那 就 不 会 重新 创建 Activity 实例 ， 只 会 调 
用 onNewIntent 方法 ， 如 果 新 打开 的 Activity 不 在 栈 项 ， 而 是 在 栈 底 或 者 栈 中 间 ， 还 是 会 创建 一 个 
新 的 实例 。 

3. singleTask 〈 栈 内 复 用 模式 ) 

singleTask 模式 下 , 如 果 打开 一 个 新 的 Activity, 这 个 Activity 在 栈 中 存在 , 就 会 把 这 个 Activity 
之 上 的 Activity 都 销毁 ， 然 后 这 个 Activity 就 会 置顶 。 

假设 现在 有 三 个 Activity， 即 Activity1、Activity2、Activity3， 给 Activityl 设置 成 singleTask 
模式 。Activityl 启动 Activity2，Activity2 启动 Activity3。 这 时 任务 栈 效果 如 图 3-21 左边 的 情况 ， 
里 面 有 三 个 Activity， 栈 顶 是 Activity3， 这 个 时 候 我 们 开启 Activity1， 运行 之 后 效果 如 图 3-21 右边 
所 示 ， 任 务 栈 只 有 Activityl 还 会 存在 。 


Activity 3 
Activity 2 
Activity 1 Activity 1 


图 3-21 singleTask 模式 





使 用 singleTask 模式 有 以 下 两 点 需要 注意 : 

@ 如果 是 其 他 App 以 singleTask 模式 启动 Activity1， 将 会 创建 一 个 新 的 任务 栈 。 

@ 如果 以 singleTask 模式 启动 的 Activityl 已 经 在 后 台 的 一 个 任务 栈 中 ， 那 么 启动 后 ， 后 台 的 任 
务 栈 一 起 切换 到 前 台 。 
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4. singlelnstance (全 局 唯一 模式 ) 

singleInstance 模式 比较 特殊 ， 这 种 模式 下 的 Activity 会 单独 占用 一 个 栈 , 这 个 栈 在 整个 系统 中 
是 唯一 的 。 不 同 的 App 去 打开 singleInstance 模式 的 Activity， 如 果 这 个 实例 存在 ， 不 会 重新 创建 。 
系统 中 永远 只 会 有 一 个 这 样 的 实例 。 








3.2 Service (服务 ) 


Service 是 在 Android 后 台 运 行 的 组 件 ， 能 够 在 后 台 做 一 些 耗 时 较 长 的 事情 ， 这 样 就 不 会 影响 
应 用 体验 了 。 另 外 ， 当 程序 退出 到 后 台 时 ， 也 可 以 让 Service 继续 运行 。 例 如 ， 首 先 打开 了 一 个 音 
乐 播放 器 ， 这 时 又 想 打 开 籁 信 刷 朋友 圈 ， 并 且 让 音乐 播放 器 继续 播放 音乐 ， 就 可 以 用 Service 在 后 
台 播 放 音乐 了 。 





3.2.1 Activity 中 启动 Service 以 及 销毁 Service 


首先 新 建 一 个 LocalService 类 ， 继 承 Service， 重 写 onCreate、onStartCommand、onDestroy 方 
法 。 在 每 个 方法 中 都 打印 Log。 


Public class LocalService extends Servicet 
@Override 
public void onCreate() { 
Log.i("LocalService", "onCreate"); 
super.onCreate(); 
} 


@Override 

public int onStartCommand (Intent intent, int flags, int startId) { 
Log.i("LocalService","onStartCommand start id " + startId); 
return super.onStartCommand (intent, flags, startId); 

} 


@Override 

public void onDestroy() { 
super.onDestroy(); 
Log.i("LocalService", "onDestroy"); 

} 


QOverride 
Public IBinder onBind(Intent intent) { 
return null; 
} 
' 


Service 组 件 和 Activity 一 样 ， 一 定 要 记 住 在 AndroidManifest.xml 文件 中 注册 : 


<service android:name="com.ansen.service.LocalService"/> 
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接 下 来 ， 在 activity_main.xml 文件 中 添加 两 个 按钮: 


<?xml Version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<Button 
android:id="@+id/btn start service" 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:text="Start Service" /> 


<Button 
android:id="@+id/btn stop service" 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:text="Stop Service"/> 
</LinearLayout> 


在 MainActivity 中 设置 两 个 点 击 事件 ,这 种 代码 前 面 介绍 很 多 次 了 ， 大 家 应 该 非常 熟悉 。 通 过 
startService 方法 启动 服务 ， 通 过 stopService 方法 停止 服务 ， 两 个 方法 都 是 传 入 一 个 Intent 对 象 。 


Public class MainActivity extends AppCompatActivity implements 
View.OnClickListener{ 
@Override 
Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 


findViewById(R.id.btn start service).setOnClickListener (this); 
findViewById(R.id.btn stop service) .setOnClickListener (this); 
上 


@Override 
public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.btn start service:// 启 动 Service 
Intent startIntent=new Intent (this,LocalService.class); 
startService (startIntent); 
break; 
case R.id.btn stop service:// 停 止 Service 
Intent stopIntent=new Intent (this,LocalService.class); 
stopService (stopIntent); 
break; 


} 


接 下 来 是 点 击 按钮 ， 通 过 Log 来 分 析 Service 的 执行 过 程 。 第 一 次 点 击 Start Service 按钮 时 ， 
调用 了 Service 的 onCreate 和 onStartCommand 方法 。 








01-19 13:40:42.950 14814-14814/com.ansen.service I/LocalService: onCreate 
01-19 13:40:42.950 14814-14814/com.ansen.service I/LocalService: 
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onStartCommand start id 1 


再 次 点 击 Start Service 按钮 ， 仅 调用 了 onStartCommand 方法 ，startId 从 之 前 的 1 变 成 了 2。 从 
这 个 打印 的 Log 中 可 以 知道 Service 启动 了 就 保存 在 后 台 ， 第 二 次 启动 只 会 调用 onStartCommand 
方法 ， 只 要 Service 没有 被 销毁 ， 不 管 启动 多 少 次 都 不 会 调用 onCreate， 通 过 startId 可 以 知道 启动 
了 多 少 次 。 


01-19 13:46:33.970 14814-14814/com.ansen.service I/LocalService: 
onStartCommand start id 2 





点 击 Stop Service 按钮 ，onDestroy 运行 了 ，Service 就 销毁 了 。 


01-19 14:02:38.700 14814-14814/com.ansen.service I/LocalService: onDestroy 


Service 与 Thread 是 什么 关系 ? 
其 实 Service 与 Thread 没有 任何 关系 , 之 所 以 有 不 少 人 会 将 它们 联系 起 来 , 主要 就 是 因为 Service 的 后 


台 概念 .Thread 用 于 开启 一 个 子 线程 , 在 这 里 去 执行 一 些 耗 时 操作 而 不 会 阻塞 主线 程 的 运行 .而 Service 
最 初 理解 时 ， 总 会 党 得 它 是 用 来 处 理 一 些 后 台 任务 的 ， 一 些 比较 耗 时 的 操作 也 可 以 放 在 这 里 运行 ， 就 
会 让 人 产生 混淆 了。 但 是 ， 如 果 告 诉 你 Service 其 实 是 运行 在 主线 程 中 的 ， 还 会 觉得 它 和 Thread 有 什 
么 关系 吗 ? 





改动 3.2.1 节 中 的 示例 代码 ， 在 MainActivity 的 onCreate 方法 中 加 一 名 代码 打印 当前 线程 id: 
Log.i("MainActivity","onCreate ThreadId:"+android.os.Process.myTid()) 7， 
同样 ， 在 LocalService 的 onCreate 方法 中 也 打印 当前 线程 id: 
Log.i("LocalService","onCreate ThreadId:"+android.os.Process.myTid())， 


重新 运行 程序 ， 点 击 Start Service 按钮 ， 打 印 Log 如 下 ， 可 以 看 到 线程 id 是 一 样 的 。 由 此 证 
实 了 Service 确实 是 运行 在 主线 程 中 的 ， 也 就 是 说 ， 如 果 在 Service 中 编写 了 非常 耗 时 的 代码 ， 程 序 
会 出 现 “应 用 程序 无 响应 ”对 话 框 。 如 何 解决 这 个 问题 呢 ? 可 以 在 Service 中 新 建 一 个 线程 ， 执 行 
耗 时 比较 大 的 工作 ， 例 如 音乐 播放 器 下 载 歌 曲 ， 就 可 以 在 Service 中 开启 一 个 线程 去 做 这 件 事情 。 

01-19 14:10:02.160 24514-24514/com.ansen.service I/MainActivity: onCreate 
ThreadId:24514 


01-19 14:10:04.050 24514-24514/com.ansen.service I/LocalService: onCreate 
ThreadId:24514 





为 什么 还 需要 Service? 
我 们 都 知道 在 主线 程 可 以 用 Thread 开启 一 个 线程 去 执行 一 些 耗 时 的 操作 ， 这 样 不 会 阻塞 UI， 但 是 如 


果 当 前 的 Activity 销毁 了 , 就 没有 办 法 获取 Thread 的 实例 , 也 就 不 能 再 去 操作 那个 Thread。 这 样 Thread 
的 生命 周期 和 Activity 就 绑 定 在 一 起 了 。Service 不 一 样 ， 只 要 启动 了 没有 销毁 ， 就 一 直 存 在 后 台中 ， 
多 个 Activity 能 和 一 个 Service 进行 关联 调用 。 
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3.2.2 ”Activity 与 Service 通信 





细心 的 读者 会 发 现 ，LocalService 类 中 还 有 一 个 onBind 方法 ， 只 要 重 写 了 Service 类 ， 就 必须 
要 实现 这 个 方法 。 这 个 方法 有 一 个 返回 值 ， 是 一 个 IBinder 对 象 。Activity 和 Service 通信 就 是 通过 
这 个 对 象 来 实现 的 。 

我 们 继续 修改 LocalService， 其 改动 如 下 : 

@ 编写 一 个 内 部 类 LocalBinder, 继承 自 Binder, 增加 一 个 getService 方法 返回 当前 Service 对 象 。 

@ 实例 化 LocalBinder， 在 onBind 方法 中 将 LocalBinder 类 的 实例 返回 。 

@ 增加 downMusic 方法 模拟 下 载 音乐 ， 提 供 Activity 调用 。 








Public class LocalService extends Service{ 
Private final IBinder mBinder = new LocalBinder(); 


@Override 

public void onCreate() { 
Log.i("LocalService", "onCreate ThreadId:"+android.os.Process.myTid()); 
super.onCreate(); 


. 


@Override 

public int onStartCommand (Intent intent, int flags, int startId) { 
Log.i("LocalService","onStartCommand start id " + startId); 
return super.onStartCommand (intent, flags, startId); 

} 


@Override 

Public void onDestroy() { 
super.onDestroy(); 
Log.i("LocalService", "onDestroy"); 

} 


@Override 

Public IBinder onBind(Intent intent){ 
Log.i("LocalService", "onBind"); 
return mBinder; 


’ 


// 下 载 音乐 的 方法 

public void downMusic(){ 
// 这 里 我 只 是 打印 了 一 个 Log， 如 果 在 开发 中 需要 下 载 音乐 ， 开 一 个 线程 去 下 载 
Log.i("LocalService", "downMusic"); 

} 


Public class LocalBinder extends Binder{ 
// 返 回 当前 的 service 对 象 
LocalService getService() { 
return LocalService.this; 
和 
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继续 修改 activity_main.xml 布局 文件 ， 增 加 Bind Service 和 Unbind Service 两 个 按钮 : 


<?xml Version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<Button 
android:id="@+id/btn start service" 
androi ayout width="match Parent" 
android:layout height="wrap content" 
android:text="Start Service" /> 






<Button 
android:id="@+id/btn stop service" 
androi ayout width="match parent" 
android:layout height="wrap content" 
android:text="Stop Service"/> 





<Button 

android:id="@+id/btn bind service" 
ayout width="match parent" 
layout height="wrap content" 
android:text="Bind Service" /> 





<Button 
android:id="@+id/btn unbind service" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Unbind Service"/> 
</LinearLayout> 
接 下 来 查看 MainActivity， 如 果 点 击 了 Bind Service 按钮 ， 通 过 bindService 方法 将 Activity 和 
Service 绑 定 起 来 ， 它 有 三 个 参数 : 
@ 参数 一 : Intent 实例 。 
@ 参数 二 : ServiceConnection 接口 实例 ，Activity 和 Serivice 绑 定 与 解除 绑 定 都 会 调用 它 。 通 过 
内 部 类 方式 实例 化 ServiceConnection， 其 中 重 写 了 两 个 方法 ，onServiceConnected 是 Activity 
和 Service 连接 时 调用 ，onServiceDisconnected 是 解 绑 时 调用 。 在 onServiceConnected 方法 中 ， 
通过 binder 来 获取 连接 的 Service 实例 。 拿 到 了 Service 实例 之 后 , 可 以 调用 Service 中 的 任何 
public 方法 。 
@ 参数 三 : 一 个 标志 位 ， 有 很 多 值 ， 例 如 BIND_AUTO_CREATE、BIND_DEBUG_UNBIND 和 
BIND_ NOT_ FOREGROUND 等 。 其 中 ，BIND_AUTO_CREATE 表示 当 收 到 绑 定 请 求 时 ， 如 
果 Service 尚未 创建 ， 就 即刻 创建 。 
绑 定 成 功 状 用 mIsBound 成 员 变 量 来 标示 ,在 MainActivity 中 可 以 通过 这 个 变量 来 判断 是 否 绑 
定 了 Service。 


Unbind Service 按钮 的 代码 比较 简单 ， 通 过 mIsBound 判断 是 否 绑 定 。 如 果 绑 定 了 调用 
unbindService 方法 解 绑 ， 传 入 ServiceConnection 实例 。 
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我 们 还 重 写 了 Activity 的 onDestroy 方法 , 调用 unbindService 方法 解 绑 ,如果 忘记 手动 解 绑 了 ， 
Activity 销毁 时 也 能 解 绑 。 

如 果 没 有 重 写 ， 而 且 又 绑 定 Service ，MainActivity 销毁 时 会 报错 “Activity has leaked 
ServiceConnection that was originally bound here”， 所 以 必须 要 解 绑 。 

















public class MainActivity extends AppCompatActivity implements 
View.OnClickListener{ 
private LocalService localService;//service 对 象 
private boolean mIsBound;// 是 否 绑 定 


ServiceConnection serviceConnection=new ServiceConnection() { 
//Activity 与 Service 绑 定 时 调用 
override 
Public void onServiceConnected (ComponentName name, IBinder binder) { 
localService=((LocalService.LocalBinder)binder) .getService(); 
localService.downMusic() ;// 调 用 下 载 音乐 的 方法 
} 


//Activity 与 Service 解 绑 时 调用 
@Override 
public void onServiceDisconnected(ComponentName name) { 
localService=null; 
由 
rs 


@Override 

protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (SavedInstanceState) 7 
setContentView(R.layout.activity main); 


Log.i("MainActivity", "onCreate ThreadId:"+android.os.Process.myTid()); 


findViewById(R.id.btn start service).setOnClickListener (this); 
findViewById(R.id.btn stop service).setOnClickListener (this); 


findViewById(R.id.btn bind service).setOnClickListener (this); 
findViewById(R.id.btn unbind service) .setOnClickListener (this); 
3 


@Override 
Public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.btn start service:// 启 动 Service 
Intent startIntent=new Intent (this,LocalService.class); 
StartService (startIntent) 
break; 
case R.id.btn stop_service:// 停 止 Service 
Intent stopIntent=new Intent (this,LocalService.class); 
stopService (stopIntent); 
break; 
case R.id.btn bind service:// 绑 定 Service 
Intent bindIntent=new Intent (this,LocalService.class); 
bindService (bindIntent,serviceConnection, BIND RUTO CREATE); 
mIsBound = true; 
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break; 

case R.id.btn unbind service:// 取 消 绑 定 Service 
unbindService(); 
break; 


} 


private void unbindService(){ 
if(mIsBound){ 
unbindService (serviceConnection); 
mIsBound=false; 


} 


Q@Override 

protected void onDestroy() { 
super.onDestroy(); 
unbindService(); 


上 

运行 代码 ,首先 点 击 Bind Service 按钮 , 打印 log 内 容 如 下 ， 从 log 中 看 到 调用 了 LocalService 
类 的 onCreate、onBind 方法 ， 并 没有 调用 onStartCommand 方法 ，downMusic 是 ServiceConnection 
的 onServiceConnected 方法 中 调用 的 。 


01-23 10:46:06.261 28645-28645/com.ansen.service I/LocalService: onCreate 
ThreadId:28645 

01-23 10:46:06.261 28645-28645/com.ansen.service I/LocalService: onBind 

01-23 10:46:06.261 28645-28645/com.ansen.service I/LocalService: downMusic 





点 击 Unbind Service 按钮 ， 打 印 log 如 下 ， 调 用 Service 的 onDestroy 方法 ， 说 明 service 已 销 
毁 。 
01-23 10:49:08.061 28645-28645/com.ansen.service I/LocalService: onDestroy 


如 果 同 时 启动 Service， 又 绑 定 Service 会 发 生 什 么 情况 呢 ? 首先 点 击 Start Service 按钮 ， 再 点 
击 Bind Service 按钮 ， 从 Log 中 可 以 得 出 一 个 结论 ，Service 的 onCreate 只 会 执行 一 次 ， 也 就 是 说 
后 台 只 有 一 个 Service。 


01-24 17:35:18.741 4696-4696/com.ansen.service I/LocalService: onCreate 
ThreadId:4696 

01-2417:35:18.741 4696-4696/com.ansen.service I/LocalService: onStartCommand 
start id 1 

01-24 17:35:23.361 4696-4696/com.ansen.service I/LocalService: onBind 

01-24 17:35:23.361 4696-4696/com.ansen.service I/LocalService: downMusic 


继续 点 击 Stop Service 按钮 ， 发 现 Log 中 什么 日 志 也 没有 打印 ， 然 后 点 击 Unbind Service， 打 
印 执行 onDestroy 方法 的 Log。 也 就 是 说 ,如 果 既 调用 了 startService 方法 又 调用 了 bindService 方法 ， 
就 必须 调用 stopService 和 unbindService 才能 销毁 这 个 Service。 


01-24 17:39:31.641 4696-4696/com.ansen.service I/LocalService: onDestroy 
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3.3 Broadcast Receiver (广播 接收 器 ) 


Broadcast Receiver 用 来 发 送 或 接收 广播 。Android 应 用 程序 可 以 发 送 或 接收 来 自 Android 系统 
和 其 他 Android 应 用 程序 的 广播 消息 ， 类 似 于 发 布 订阅 设计 模式 。 例 如 ，Android 系统 在 各 种 系统 
事件 发 生 时 发 送 广播 (如 系统 启动 或 设备 开始 充电 时 ) 。 应 用 程序 还 可 以 发 送 自 定义 广播 ， 例 如 通 
知 其 他 应 用 程序 的 内 容 〈 一 些 新 的 数据 已 被 下 载 等 ) 。 应 用 程序 可 以 注册 接收 特定 的 广播 。 当 发 送 
广播 时 ， 系统 自动 将 广播 路 由 到 订阅 该 特定 类 型 广播 的 应 用 程序 。 一 般 来 说 , 广播 可 以 作为 跨 应 用 

















程序 跟 应 用 内 的 消息 传递 系统 。 


3.3.1 动态 注册 广播 


动态 注册 广播 是 一 种 灵活 的 注册 方式 ， 通 过 代码 来 注册 广播 或 销毁 广播 。 


首先 新 建 DynamicBroadcast 类 ， 继 承 BroadcastReceiver 类 ， 用 来 接收 广播 ， 重 写 onReceive 


方法 ， 通 过 onReceive 方法 intent 参数 可 以 获取 发 送 广播 时 传 入 的 参数 。 


Public class DynamicBroadcast extends BroadcastReceiver { 
@Override 
Public void onReceive (Context context, Intent intent){ 
String data = intent.getStringExtra("data") 7 
Log.i("data",data); 


和 
在 activity_main.xml 文件 中 增加 一 个 按钮 : 


<?xml Version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:id="@+id/btn dynamic broadcast send message" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 给 动态 注册 的 广播 发 送 消息 "/> 


</LinearLayout> 
最 后 查看 一 下 MainActivity.java 文件 。 
public class MainActivity extends AppCompatActivity implements 
View.OnClickListener{ 
Public static final String ACTION DYNAMIC BROADCAST= 


"android.intent.action.DYNAMIC BROADCAST"; 
Private DynamicBroadcast dynamicBroadcast; 


@Override 
Protected void onCreate (Bundle savedInstanceState) { 
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Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity main) 


findViewById(R.id.btn dynamic broadcast send message) . 
setOnClickListener (this); 


// 动 态 注册 广播 

dynamicBroadcast=new DynamicBroadcast () 7 

IntentFilter intentFilter=new IntentFilter (ARCTION DYNAMIC BRORADCRST) 
registerReceiver (dynamicBroadcast, intentFilter); 


} 


Q@Override 
public void onClick(View v) 1{ 
Switch (v.getId()){ 
case R.id.btn dynamic broadcast send message: 
Intent intent = new Intent (ACTION DYNAMIC BROADCAST); 
intent.putExtra("data", "Dynamic Broadcast Parameter"); 
// 通 过 intent 传递 参数 

sendBroadcast (intent);// 发 送 广 播 消息 
break; 


b 


@Override 

Protected void onDestroy() { 
super.onDestroy(); 
Log.i("MainActivity onDestroy", "销毁 广播 ") ; 
unregisterReceiver (dynamicBroadcast); 


在 onCreate 中 通过 registerReceiver 方法 注册 一 个 广播 ， 需 要 BroadcastReceiver 和 IntentFilter 
对 象 两 个 参数 。 同 时 给 “发 送 广播 ”按钮 设置 点 击 监听 ， 点 击 之 后 通过 sendBroadcast 方法 发 送 广 
播 ， 这 里 需要 一 个 Intent 对 象 ， 构 造 ntent 对 象 时 传 入 Action， 这 个 Action 与 注册 广播 时 的 Action 
一 致 。 

我 们 还 重 写 了 onDestroy 方法 ， 当 Activity 销毁 时 也 销毁 广播 ， 因 此 本 例 中 广播 的 生命 周期 和 
Activity 是 一 样 的 。 

运行 代码 ， 点 击 “ 给 动态 注册 的 广播 发 送 消息 ”按钮 ，Log 打印 如 下 : 

02-03 16:32:11.194 7095-7095/com.ansen.broadcastreceiver I/data: Dynamic 
Broadcast Parameter 


3.3.2 ”静态 注册 广播 


静态 注册 广播 是 在 AndroidManifest.xml 文件 中 注册 的 ， 无 论 这 个 程序 是 否 启动 ， 都 会 接收 到 
这 个 广播 。 

在 动态 注册 广播 的 Demo 上 增加 代码 ， 新 建 StaticBroadcast 类 ， 继 承 BroadcastReceiver， 实 现 
onReceive 方法 ， 和 动态 广播 的 接收 器 代码 几乎 一 样 。 
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Public class StaticBroadcast extends BroadcastReceivert{ 
Override 
Public void onReceive (Context context, Intent intent){ 
String data = intent.getStringExtra("data"n) 7 
Log.i("data",data); 


接 下 来 需要 在 AndroidManifest.xml 文件 中 注册 这 个 广播 ,通过 receiver 标签 的 name 属性 指定 
类 ， 再 增加 intent-filter 标签 ， 给 action 标签 设置 name 属性 值 ， 发 送 广播 时 需要 用 到 此 值 。 


<receiver android:name=".StaticBroadcast" android:exported="true"> 
<intent-filter> 
<action android:name="android.intent.action.STRTIC BROADCAST"/> 
</intent-filter> 
</receiver> 


在 activity_main.xml 文件 中 增加 一 个 “给 静态 注册 的 广播 发 送 消 息 ” 的 按钮 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:id="@+id/btn dynamic broadcast send message" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 给 动态 注册 的 广播 发 送 消 息 "/> 
<Button 
android:id="@+id/btn static broadcast send message" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 给 静态 注册 的 广播 发 送 消 息 "/> 


</LinearLayout> 

在 MainActivity 中 给 “静态 注册 的 广播 发 送 消 息 ” 的 按钮 设置 点 击 监听 事件 , 在 对 应 的 onClick 
方法 中 发 送 广播 ， 从 如 下 代码 中 可 以 看 到 Intent 的 构造 方法 有 传 入 一 个 字符 串 ， 这 个 值 与 在 XML 
中 receiver 标签 一 intent-filter 一 action 的 name 属性 的 值 必须 一 致 .在 广播 底层 源码 中 就 是 通过 action 
来 区 分 不 同 的 广播 接收 者 。 

Intent staticIntent = new Intent ("android.intent.action.STATIC BROADCAST"); 

staticIntent .putExtra("data","Static Broadcast Parameter"); 

// 通 过 intent 传递 参数 

sendBroadcast (staticIntent);// 发 送 广 播 消 息 

因为 没有 增加 很 多 代码 ，MainActivity 的 代码 就 不 全 部 贴 出 来 了 ， 重 新 运行 代码 ， 点 击 “ 给 静 
态 注 册 的 广播 发 送 消息 ”按钮 ， 打 印 的 Log 如 下 : 

02-06 14:02:38.735 10749-10749/com.ansen.broadcastreceiver I/data: Static 
Broadcast Parameter 
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3.3.3 广播 基本 总 结 


1. 动态 注册 广播 与 静态 注册 广播 的 区 别 

前 面 写 了 一 个 Demo， 也 介绍 了 动态 注册 广播 与 静态 注册 广播 ， 这 里 再 总 结 一 下 。 

e@ 动态 注册 : 广播 的 生命 周期 自己 灵活 控制 ， 消 耗资 源 少 。 

@ ”静态 注册 : 广播 一 直 存 在 ， 除 非 印 载 软 件 。 消 耗资 源 稍微 大 一 些 。 当 然 ， 现 在 的 手机 硬件 都 

跟 得 上 了 ， 这 点 资源 可 以 忽略 不 计 。 

2. 广播 注意 事项 

我 们 都 知道 收 到 了 广播 就 会 执行 onReceive 方法 ， 但 是 在 这 个 方法 中 不 能 进行 耗 时 超过 10 秒 
的 事情 ， 否 则 会 弹出 “应 用 程序 无 响应 ” (ANR，Application Not Response) 对 话 框 。 如 果 有 特殊 
需要 ， 可 以 再 启动 一 个 Thread 处 理 耗 时 操作 。 


3.3.4 ”应 用 内 广播 LocalBroadcastManager 


在 Android 系统 中 ，BroadcastReceiver 设计 的 初 囊 是 从 全 局 考虑 ， 能 够 方便 应 用 程序 和 系统 、 
应 用 程序 之 间 、 应 用 程序 内 的 通信 。 因 此 ， 对 单个 应 用 程序 而 言 ，BroadcastReceiver 是 存在 安全 性 
问题 的 (恶意 程序 脚本 不 断 地 去 发 送 你 所 接收 的 广播 ) 。 为 了 解决 这 个 问题 ,我 们 就 需要 使 用 应 用 
内 广播 LocalBroadcastManager。 

LocalBroadcastManager 是 Android Support 包 提 供 的 一 个 工具 , 用 来 在 同一 个 App 内 的 不 同 组 
件 之 间 发 送 Broadcast， 可 以 解决 BroadcastReceiver 的 安全 问题 〈 恶 意 程序 脚本 不 断 地 发 送 所 接收 
的 广播 ) 。 

使 用 LocalBroadcastManager 具有 以 下 好 处 : 

@ 发送 的 广播 只 会 在 自己 App 内 传播 ， 不 会 泄露 给 其 他 App， 确 保 隐私 数据 不 会 泄露 。 

@ 其 他 App 也 无 法 向 你 的 App 发 送 该 广播 ， 不 用 担心 其 他 App 会 来 搞 破坏 。 

@ ”上 比 系 统 全 局 广播 更 加 高 效 。 


LocalBroadcastManager 的 使 用 方法 与 动态 注册 广播 类 似 。 首 先 需要 获取 LocalBroadcastManager 
对 象 ， 通 过 getInstance 方 法 ( 单 例 模 式 ) 获取 ， 然 后 调用 registerReceiver 方法 。 


broadcastManager = LocalBroadcastManager .getInstance (this); 

localReceiver=new LocalBroadcastReceiver(); 

broadcastManager.registerReceiver (localReceiver,new 
IntentFilter (ACTION LOCAL BROADCAST)); 


发 送 广播 也 类 似 。 这 里 一 定 需要 调用 LocalBroadcastManager 对 象 的 sendBroadcast 方法 来 发 送 
广播 ， 不 然 接 收 不 到 广播 。 


Intent localIntent=new Intent (ACTION LOCAL BRORADCRAST) 
localIntent.putExtra("data", "Local Broadcast Parameter") ;// 通 过 intent 传递 参数 
LocalBroadcastManager .getInstance (this) .sendBroadcast (localIntent) 7 
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顺便 在 onDestroy 方法 中 对 广播 进行 反 注 册 。 


QOverride 

Protected void onDestroy(){ 
Super .onDestroy (); 
Log.i("MainActivity onDestroy"， "销毁 广播 ") 
unregisterReceiver (dynamicBroadcast); 
broadcastManager .unregisterReceiver (localReceiver); 


i 
因为 和 动态 注册 广播 类 似 ， 所 以 这 里 仅 贴 出 了 关键 代码 。 


3.4 ”ContentProvider ( 内 容 提 供 者 ) 


ContentProvider 是 Android 中 的 四 大 组 件 之 一 ， 主 要 用 于 对 外 共享 数据 ， 也 就 是 通过 
ContentProvider 将 应 用 中 的 数据 共享 给 其 他 应 用 访问 , 其 他 应 用 可 以 通过 ContentProvider 对 指定 应 
用 中 的 数据 进行 操作 。 

下 面 介绍 如 何 使 用 ContentProvider 获取 手机 联系 人 列表 。 联 系 人 App 是 每 个 Android 手机 都 
会 内 置 的 应 用 程序 , 这 些 联系 人 数据 保存 在 sqlite 数据 库 中 。 如 果 你 的 应 用 程序 想 获取 联系 人 数据 ， 
就 可 以 通过 ContentProvider 方式 获取 。 

这 里 需要 借助 ContentResolver 类 ， 在 Activity 中 调用 getContentResolver 方法 即 可 获取 。 下 面 

查询 联系 人 列表 ， 所 以 调用 ContentResolver 类 的 query 方法 。 


Cursor query(Uri uri,String[] projection,String selection,String[] 
selectionArgs, String sortOrder) 


这 个 方法 提供 5 个 参数 : 


euri: 暴露 给 外 部 App 的 唯一 标示 ， 例 如 有 提供 联系 人 的 、 有 提供 短信 的 、 有 提供 图 片 的 ， 总 
归 要 区 分 开 来 。 ContactsContract.CommonDataKinds.Phone.CONTENT_URI 就 是 提供 联系 人 的 


uri。 
@ projection: 返回 列 (字段 )， 例 如 联系 人 表 中 包括 id、name、phone 等 字段 ， 如 果 想 要 返回 表 
中 全 部 的 字段 直接 填 null。 


selection: 设置 条 件 ， 相 当 于 SQL 语句 中 的 where。null 表示 不 进行 筛选 。 

@ selectionArgs: 这 个 参数 是 配合 第 三 个 参数 使 用 的 ， 如 果 在 第 三 个 参数 中 有 “?”， 那 么 在 
selectionArgs 写 的 数据 就 会 蔡 换 为 “?”。 

@ sortOrder: 按照 什么 进行 排序 ， 相 当 于 SQL 语句 中 的 Order by。 例 如， 想 要 结果 按照 id 降序 
排列 ， 可 以 写成 android.providerContactsContractContacts. ID + "DESC"。 

这 个 方法 返回 的 是 Cursor 对 象 〈Cursor 翻译 成 中 文 为 “游标 ”) ， 其 实 就 是 一 个 结果 集 ， 可 

以 从 这 个 对 象 中 遍历 出 查询 结果 。 
查询 手机 联系 人 列表 代码 如 下 : 


Private void readContacts (){ 
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Cursor cursor=null; 
tryt{ 
cursor=getContentResolver() .query( 
ContactsContract .CommonDataKinds .Phone .CONTENT URI,null, 
null,null,null 
); 
while(cursor.moveToNext ()){ 
String displayName =cursor.getString(cursor.getColumnIndex 
(ContactsContract.CommonDataKinds.Phone.DISPLAY NAME)); 
String number=cursor.getString (cursor.getColumnIndex 
(ContactsContract .CommonDataKinds .Phone .NUMBER)); 
Log.i("ansen", "显示 名 字 :"+displayName+" 电话 号 码 :"+number); 
} 
}catch (Exception e){ 
e.printStackTrace (); 
}finally { 
if(cursor!=null){ 
cursor.close() ;// 在 finally 中 关闭 游标 
» 
下 
} 


首先 查找 所 有 的 联系 人 数据 ， 返 回 Cursor 对 象 ， 然 后 while 循环 Cursor， 看 到 while 中 的 条 件 
是 cursor.moveToNext()， 这 个 方法 首先 会 判断 还 有 没有 下 一 条 记录 ， 如 果 有 就 将 游标 指向 下 一 条 ; 
如 果 没 有 下 一 条 ， 就 返回 false， 循 环 结束 。 

用 ContentProvider 可 以 访问 很 多 系统 App 的 数据 , 借助 于 网 页 搜索 , 读者 可 以 自己 尝试 一 下 。 
当然 ， 也 可 以 通过 ContentProvider 将 自己 App 的 数据 提供 给 其 他 App 访问 。 


3.5 “本章 小 结 


本 章 学 习 了 Android 中 最 重要 的 四 大 组 件 ， 作 为 一 个 Android 开发 者 ， 必 定 离 不 开 四 大 组 件 。 
在 企业 真实 开发 中 ，Activity 使 用 更 频繁 ， 所 以 内 容 也 是 最 多 的 。 

从 Activity 的 生命 周期 到 Activity 四 种 启动 模式 ， 由 浅 到 深 系 统 全 面 地 介绍 了 Activity， 学 习 
了 Toast， 在 提示 内 容 上 又 多 了 一 个 选择 (需要 用 户 交互 使 用 Dialog， 短 暂 内 容 提 示 使 用 Toast) ， 
还 学 习 了 Activity 启动 与 退出 动画 、 在 界面 跳 转 时 添加 动画 效果 ， 使 App 更 加 流畅 ， 体 验 更 好 。 
Activity 四 种 启动 模式 的 使 用 可 以 让 用 户 更 好 地 管理 Activity 。 

学 习 了 Service， 可 以 让 我 们 的 App 将 一 些 耗 时 任务 放 到 后 台 运 行 ， 而 不 影响 用 户 体验 。 

接 下 来 ， 学 习 了 广播 的 两 种 注册 方式 : 动态 注册 与 静态 注册 。 可 以 根据 自己 的 应 用 场景 进行 
选择 。 此 外 ， 还 介绍 了 应 用 内 广播 ， 这 样 可 以 解决 恶意 攻击 问题 ， 让 程序 运行 平稳 。 

最 后 简单 介绍 了 ContentProvider 的 使 用 ， 编 写 了 一 个 查找 联系 人 的 案例 。 

本 章 的 内 容 比较 零散 ， 而 涉及 的 知识 点 在 开发 中 却 经 常用 到 ， 希 望 大 家 能 够 熟练 掌握 这 些 组 
件 的 使 用 。 





Fragment 探索 


本 章 将 学 习 Fragment。Fragment 是 Android 3.0 被 引入 的 API， 主 要 是 体现 在 大 屏幕 〈 如 平板 
电脑 ) 上 更 加 动态 和 灵活 的 UI 设计 。 本 章 首 先 描述 了 Fragment 的 优 缺 点 ， 接 着 介绍 了 Fragment 
的 生命 周期 , 最 后 介绍 了 Fragment 的 简单 使 用 。 本 章 的 内 容 虽 不 多 , 但 需要 读者 熟练 掌握 , Fragment 
比 Activity 的 开销 要 低 很 多 , 合理 地 使 用 Fragment 可 以 对 APP 性 能 有 较 大 提升 ,使 你 的 APP 如 丝 
般 顺 滑 ， 这 种 提升 在 低 端 机 上 尤为 明显 ， 响 应 速度 甚至 能 快 好 几 售 。 


4.1 Fragment 简介 


Fragment( 片 段 ) 表 示 Activity 中 的 某 部 分 界面 或 者 行为 ， 必 须 与 Activity 配合 使 用 。 

Fragment 有 自己 的 生命 周期 ， 可 以 加 载 自己 的 布局 文件 ， 但 是 它 的 生命 周期 依赖 于 Activity， 
如 果 Activity 停止 ，Activity 加 载 的 Fragment 就 不 能 启动 ， 如果 Activity 销毁 ， 这 个 Activity 加 载 
的 所 有 Fragment 也 会 销毁 。 

说 了 这 么 多 ， 使 用 Fragment 有 哪些 好 处 呢 ? 

e 处 理 在 不 同 屏幕 显示 的 UI 问题 ， 例 如 手机 和 平板 电脑 的 适 配 问题 。 

@ ”Activity 模块 化 ， 很 多 业务 逻辑 可 以 放 在 对 应 的 Fragment 中 处 理 ， 而 Activity 只 需要 显示 隐 

藏 Fragment 就 行 。 
@ Fragment 可 以 被 不 同 Activity 使 有 用。 当然， 一 个 Activity 也 能 加 载 多 个 Fragment。 


4.2 Fragment 生命 周期 


Fragment 的 生命 周期 如 图 4-1 所 示 。 对 上 一 章节 中 Activity 组 件 掌握 熟练 的 读者 ,肯定 会 发 现 
Fragment 生命 周期 方法 跟 Activity 有 很 多 相似 之 处 。 
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User navigates The fragment is 
backward or added to the back 
fragment is stack, then 

removed/replaced removed/replaced 


1 + 


onPause!() 
ss ) The fragment 
和 * returns to the 
layout from the 
onDestroyView0 back stack 


= 
一 
onDestroy() 


+ 


Fragment is 
destroyed 


41 Fragment 的 生命 周期 


再 来 一 张 Fragment 与 Activity 对 比 的 图 片 ， 如 图 4-2 所 示 ,， 左边 是 Activity 的 生命 周期 调用 方 
法 ， 右 边 是 Fragment 生命 周期 调用 方法 。 
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onCreate() 


+ 


onCreateView() 


+ 


onActivityCreated() 


Deswoyed onDestroyView() 
+ 


onDestroy() 


+ 


onDetach() 





4-2 ”Fragment 与 Activity 生命 周期 方法 对 比 


从 图 4-2 中 看 到 ，Fragment 相 比 Activity 多 了 以 下 几 个 方法 : 


onAttach: 执行 该 方法 时 ，Fragment 与 Activity 已 经 完成 绑 定 。 
onCreateView: 返回 Fragment 显示 的 View (这 个 方法 必须 要 重 写 )。 
onActivityCreated: 与 Fragment 绑 定 的 Activity 的 onCreate 方法 已 经 执行 完成 。 


onDestroyView: 销毁 与 Fragment 有 关 的 视图 。 
onDetach: 解除 与 Activity 的 绑 定 。 


下 面 道 过 代码 来 证 实 图 4-2 中 的 内 容 ， 从 而 加 深 理 解 。 


首先 新 建 FragmentOne 类 ， 继 承 自 Fragment， 重 写生 命 周期 相关 函数 ， 打 印 Log 日 志 。 


Public class FragmentOne extends Fragment{ 
@Override 
Public void onAttach (Context context) { 
super.onAttach (context); 
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Log.i("FragmentOne","onAttach"); 
有 


Q@Override 

Public void onCreate (@Nullable Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
Log.i("FragmentOne","onCreate"); 

上 


@Override 
public View onCreateView (LayoutIinflater inflater,ViewGroup 
container,Bundle savedInstanceState) { 
Log.i("FragmentOne","onCreateView"); 
return inflater.inflate(R.layout.fragment one,null); 


} 


@Override 

Public void onActivityCreated(@Nullable Bundle savedInstanceState) { 
super.onActivityCreated(savedInstanceState); 
Log.i("FragmentOne","onActivityCreated"); 


@Override 
Public void onStart () { 
SupPer .onStart () 
Log.i("FragmentOne","onStart"); 
. 


@Override 

public void onResume() { 
super.onResume (); 
Log.i("FragmentOne","onResume"); 

EL 


@Override 
Public void onPause() { 
Super .onPause () 
Log.i("FragmentOne","onPause"); 
! 


@Override 
Public void onStop() { 
Super .onStop () 7 
Log.i("FragmentOne","onStop"); 
} 


@Override 

Public void onDestroyView() { 
super.onDestroyView (); 
Log.i("FragmentOne","onDestroyView"); 

上 


@Override 
Public void onDestroy() { 
super.onDestroy(); 
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Log.i("Fragmentl","onDestroy"); 
上 


@Override 

public void onDetach() { 
super.onDetach () 7 
Log.i("FragmentOne","onDetach"); 


} 


可 以 看 到 在 onCreateView 方法 中 返回 了 一 个 View， 这 个 View 是 通过 fragment_one 布局 文件 
进行 加 载 的 。 这 个 布局 文件 比较 简单 ， 其 中 仅 放 了 一 个 TextView。 


<?xml Version="1.0" encoding="utf-8"?> 

<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@color/colorAccent" 
android:gravity="center horizontal" 
android:padding="10dp" 
android:text=" 静 态 加 载 Fragment" /> 


Fragment 写 好 了 ， 如 何 才 能 与 Activity 关联 起 来 呢 ? 这 里 用 静态 加 载 的 方法 ， 比 较 简单 ， 在 
activity_main.xml 文件 中 通过 fragment 控件 的 name 属性 指定 Fragment。 必 须 给 它 设置 一 个 id， 不 
然 会 出 现 错误 : “android.view.InflateException: Binary XML file line #5: Error inflating class 
fragment” 。 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 
<fragment 
android:id="@+id/fragment one" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:name="com.ansen.fragment .FragmentOne"/> 
</RelativeLayout> 


运行 代码 ， 打 印 log 如 下 ， 回 调 方法 过 程 是 onAttach 一 onCreate 一 onCreateView 一 
onActivityCreated 一 onStart 一 onResume， 这 是 Fragment 创建 时 需要 调用 的 方法 。 


01-22 10:39:21.069 4987-4987/com.ansen.fragment I/FragmentOne: onAttach 

01-22 10:39:21.069 4987-4987/com.ansen.fragment I/FragmentOne: onCreate 

01-22 10:39:21.069 4987-4987/com.ansen.fragment I/FragmentOne: onCreateView 

01-22 10:39:21.081 4987-4987/com.ansen.fragment I/FragmentOne: 
onActivityCreated 

01-22 10:39:21.083 4987-4987/com.ansen.fragment I/FragmentOne: onStart 

01-22 10:39:21.095 4987-4987/com.ansen.fragment I/FragmentOne: onResume 


在 当前 页 面 按 住 系统 Home 键 , 这 时 手机 会 回 到 首页 。 打印 log 如 下 , 回调 方法 过 程 是 onPause 
onStop。 





01-22 10:40:25.341 4987-4987/com.ansen.fragment I/FragmentOne: onPause 
01-22 10:40:26.108 4987-4987/com.ansen.fragment I/FragmentOne: onStop 
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从 手机 首页 找到 App， 点 击 之 后 进入 App 首页 ， 就 会 重新 显示 FragmentOne， 打 印 log 如 下 ， 
回调 方法 过 程 是 onStart 一 onResume。 

01-22 10:41:06.193 4987-4987/com.ansen.fragment I/FragmentOne: onStart 

01-22 10:41:06.194 4987-4987/com.ansen.fragment I/FragmentOne: onResume 

接 下 来 按 住 系 统 返回 键 回 到 手机 首页 ， 这 时 当前 Activity 销毁 ,所 以 FragmentOne 也 会 跟着 销 
毁 。 应 用 程序 退出 。 打 印 log 如 下 ， 回 调 方法 过 程 是 onPause 一 onStop 一 onDestroyView 一 onDetach。 


01-22 10:42:22.282 4987-4987/com.ansen.fragment I/FragmentOne: onPause 
01-22 10:42:22.719 4987-4987/com.ansen.fragment I/FragmentOne: onStoPp 
01-22 10:42:22.719 4987-4987/com.ansen.fragment I/FragmentOne: onDestroyView 
01-22 10:42:22.719 4987-4987/com.ansen.fragment I/FragmentOne: onDetach 


4.3 FragmentManager 与 
FragmentTransaction 的 使 用 


前 面 介绍 了 静态 加 载 Fragment， 但 是 在 实际 工作 中 大 部 分 情况 都 是 动态 加 载 Fragment， 例 如 
根据 用 户 点 击 不 同 的 按钮 显示 不 同 的 Fragment。 本 节 介 绍 动态 操作 Fragment 的 两 个 类 


FragmentManager 与 FragmentTransaction。 


4.3.1 FragmentManager (Fragment 管理 类 ) 的 使 用 


FragmentManager 用 来 管理 Activity 中 的 Fragment。 在 Activity 中 操作 Fragment 通过 
Activity.getFragmentManager() 获 取 FragmentManager 实例 。 

使 用 support 扩展 包 的 时 候 需要 使 用 getSupportFragmentManager() 方 法 获取 相应 的 
FragmentManager， 需 要 特别 注意 的 是 support 扩展 包 中 的 Fragment 和 SDK 中 自 带 的 Fragment 是 
两 个 不 同 的 类 ， 两 个 FragmentManager 也 是 不 一 样 的 类 ， 不 可 混合 使 用 。 初 学 者 很 容易 弄 混 ， 如 果 
在 使 用 中 遇 到 提示 参数 类 型 不 匹配 ， 这 时 就 需要 检查 import 的 Fragment 和 FragmentManager 是 否 
在 同一 包 名 下 ， 如 不 一 致 换 成 同一 个 包 路 径 下 的 即 可 。 这 两 个 Fragment 类 虽然 包 名 不 一 致 但 是 用 
法 都 是 一 样 的 。 

FragmentManager 有 以 下 一 些 常 用 的 方法 。 

beginTransaction: 开启 Fragment 事务 ， 返 回 FragmentTransaction 对 象 。 

findFragmentById: 根据 id 查找 Fragment。 

popBackStack: 将 Fragment 从 后 台 扒 栈 中 弹出 ， 类 似 按 下 系统 返回 键 的 操作 ， 这 个 方法 是 异 
步 的 ， 底 层 队列 实现 。 

addOnBackStackChangedListener: 监听 后 台 挫 栈 变化 。 

removeOnBackStackChangedListener: 与 上 面 那 个 方法 对 应 ， 删 除 监 听 。 
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4.3.2 FragmentTransaction (Fragment 事务 ) 的 使 用 


FragmentTransaction 直接 操作 Fragment， 对 Fragment 进行 增加 、 移 除 与 替换 ， 对 Fragment 操 
作 完 毕 之 后 一 定 要 调用 FragmentTransaction.commit 方法 提交 事务 。 

学 过 SQL 语句 的 人 都 知道 ， 为 了 保证 一 件 事情 的 完整 性 ， 例 如 银行 转账 操作 : A 用 户 转 给 B 
用 户 100 元 ， 这 时 需要 执行 两 条 SQL 语句 ，A 用 户 账 户 减 去 100，B 用 户 账户 余额 增加 100， 为 了 
保证 账本 正确 ， 于 是 就 有 了 事务 ， 要 么 两 条 SQL 语句 同时 执行 成 功 ， 要 么 同时 执行 失败 。 如 果 有 
一 条 成 功 会 进行 回 滚 。 

这 里 也 是 一 样 的 ， 我 们 添加 了 一 个 Fragment， 同 时 又 删除 了 一 个 Fragment， 只 有 最 后 调用 
commit 方法 时 才 会 生效 。 

FragmentTransaction 常用 方法 有 以 下 几 种 。 


ee ee@ @ @ 


add(): 向 Activity 中 添加 一 个 Fragment。 
remove(): 从 Activity 中 删除 一 个 Fragment。 
replace(): 新 的 Fragment 替换 当前 的 Fragment。 
hide0: 隐藏 Fragment。 

show(): 显示 Fragment。 

commit():; 提交 事务 。 


4.4 ”Activity 动态 操作 Fragment 


前 面 学 习 了 Fragment 的 生命 周期 ， 以 及 在 XML 布局 文件 中 静态 加 载 Fragment， 同 时 介绍 了 
动态 操作 Fragment 的 两 个 类 FragmentManager 与 FragmentTransaction。 

理论 知识 有 了 ， 本 节 就 通过 代码 来 实现 如 何 动态 操作 Fragment， 将 在 上 一 节 写 的 案例 代码 上 
进行 修改 。 

新 建 一 个 Fragmnet， 通 过 构造 方法 传 入 一 个 int 类 型 的 值 ， 在 oncreatevView 方法 中 根据 传 入 
的 int 类 型 参数 给 TextView 设置 不 同 的 文本 以 及 不 同 的 背景 颜色 。 


Public class FragmentContainer extends Fragment { 


Private int fragmentIndex7 
Public FragmentContainer(){} 


@SuppressLint ("ValidFragment") 

Public FragmentContainer (int fragmentIndex){ 
this .fragmentIndex=fragmentIndex7 

} 


@Override 
Public View onCreateView(LayoutInflater inflater,ViewGroup container, 
Bundle savedInstanceState) { 
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View rootView=inflater.inflate(R.layout.fragment container,null); 
TextView tvContent = (TextView) rootView.findViewById(R.id.tv content); 
if(fragmentIndex==1){ 

tvContent .setText ("第 一 个 Fragment"); 

tvContent . setBackgroundResource (android.R.color.holo red light); 
}else if(fragmentIndex==2)1{ 

tvContent .setText ("第 二 个 Fragment"); 

tvContent . setBackgroundResource (android.R.color.holo orange light); 
}else if(fragmentIndex==3) { 

tvContent .setText (" 第 三 个 Fragment"); 

tvContent . setBackgroundResource (android.R.color.holo blue light); 








1; 


return rootView; 


FragmentContainer 类 对 应 的 布局 文件 是 fragment_container.xml， 也 就 是 onCreateView 方法 第 


- 行 inflate 的 布局 ， 里 面 就 包含 了 一 个 TextView， 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:id="@+id/tv content" 
android:gravity="center" 
android:text="Fragment" 
android:background="Q@android:color/holo green dark"/> 


再 来 查看 首页 activity_main.xml 布局 文件 有 哪些 改动 , 其 中 增加 了 5 个 按钮 点击 之 后 对 应 上 
面 列 出 来 FragmentTransaction 的 5 个 方法 。 再 增加 FrameLayout 布局 ， 用 来 显示 Fragment。 我 们 可 
以 看 到 xml 文件 中 新 增 的 FrameLayout 是 没有 指定 android:name 属性 的 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<fragment 


android:id="@+id/fragment one" 
android:name="com.ansen.fragment .FragmentOne" 
android:layout width="match parent" 
android:layout height="wrap content" /> 


<LinearLayout 


android:layout width="match parent" 
android:layout height="wrap content" 
android:orientation="horizontal"> 


<Button 
android:id="@+id/btn add" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Add" /> 
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<Button 
android:id="@+id/btn remove" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Remove" /> 


<Button 
android:id="@+id/btn replace" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Replace" /> 


<Button 
android:id="@+id/btn hide" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Hide" /> 


<Button 
android:id="@+id/btn_ show" 
android:layout width="0dp" 
android:layout heigh wrap_content" 
android:layout weight="1" 
android:text="Show" /> 
</LinearLayout> 






<FrameLayout 
android:id="@+id/fl1 container" 
android:layout width="match parent" 
android:layout height="match parent" /> 
</LinearLayout> 


MainActivity.java 也 要 进行 修改 ， 在 onCreate 方法 中 初始 化 三 个 Fragment， 传 入 一 个 int 类 型 
参数 就 可 以 初始 化 不 同 背景 文字 的 Fragment， 给 各 个 按钮 设置 点 击 事件 ， 可 以 看 到 点 击 回调 的 
onClick 方法 中 第 一 行 开启 一 个 Fragment 事务 , 最 后 一 行 调用 commit 进行 事务 提交 。 与 做 Java Web 
开发 每 次 操作 数据 库 一 样 ， 需 要 保证 一 致 性 。 

public class MainActivity extends AppCompatActivity implements 
View.OnClickListenert{ 

Private FragmentContainer fragmentOne; 


Private FragmentContainer fragmentTwo; 
Private FragmentContainer fragmentThree; 





@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


fragmentOne=new FragmentContainer (1); 
fragmentTwo=new FragmentContainer (2); 
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fragmentThree=new FragmentContainer (3) 7 


findViewById(R.id.btn add) .setOnClickListener(this); 
findViewById(R.id.btn remove) .setOnClickListener (this); 
findViewById(R.id.btn replace) .setOnClickListener (this); 
findViewById(R.id.btn hide) .setOnClickListener (this); 
findViewById(R.id.btn show) .setOnClickListener (this); 


@Override 
public void onClick(View v) { 
// 开 启 一 个 Fragment 事务 
FragmentTransaction transaction = getSupportFragmentManager () . 
beginTransaction(); 
if(v.getId()==R.id.btn add) {// 添 加 2 个 Fragment 
transaction.add(R.id.fl container,fragmentOne); 
transaction.add(R.id.fl container,fragmentTwo); 
jelse if(v.getId()==R.id.btn remove) {// 删 除 第 2 个 
transaction.remove (fragmentTwo); 
jelse if(v.getId()==R.id.btn replace) {// 替 换 
transaction.replace (R.id.fl container,fragmentThree); 
}else if(v.getId()==R.id.btn hide){// 隐 藏 
transaction.hide (fragmentThree) 
}else if(v.getId()==R.id.btn_show){// 显 示 
transaction.show (fragmentThree) 
3 


transaction.commit (); 
1 
分 析 一 下 5 个 按钮 依次 点 击 之 后 的 效果 : 
(1) 点 击 添加 按钮 ， 先 添加 Fragment1， 再 添加 Fragment2，Activity 中 添加 了 两 个 Fragment。 
但 是 同一 个 View 只 能 显示 一 个 Fragment， 后 面 添加 的 会 显示 在 最 上 面 ， 所 以 这 时 显示 Fragment2 。 
(2) 点 击 删除 按钮 ， 删 除 Fragment2， 只 剩 下 Fragment1， 所 以 这 时 显示 Fragment1 。 
(3) 点 击 替 换 按钮 ， 将 Fragment3 替换 成 Fragment1， 所 以 这 时 显示 Fragment3 。 
(4) 点 击 隐藏 按钮 ， 这 时 只 有 Fragment3， 将 隐藏 Fragment3。FrameLayout 控件 显示 为 空白 。 
(5) 点 击 显示 按钮 ， 重 新 显示 Fragment3 。 





4.5 Fragment 与 Activity 交互 数据 


Fragment 与 Activity 交互 数据 一 般 通过 以 下 两 种 方法 : 

ee 通过 Fragmentd 构造 方法 传递 参数 (适合 动态 加 载 Fragment )。 

e 通过 依赖 注入 方式 。 

其 实 原理 都 差不多 ，Activity 拥有 Fragment 的 对 象 ， 传 递 参数 是 很 容易 的 。 在 Fragment 类 中 
写 入 一 个 set 方法 即 可 。 不 过 ， 如 果 Fragment 将 数据 处 理 完 成 之 后 又 要 调用 Activity， 就 需要 通过 
回调 。 
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在 之 前 的 代码 上 修改 FragmentOne 这 个 类 。 这 里 仅 贴 出 改动 的 代码 ， 增 加 了 两 个 实例 变量 ， 
增加 了 一 个 setOnClickListener 方法 ,用 于 Activity 设置 点 击 事件 , 在 onCreateView 方法 中 将 inflater 
返回 的 View 赋值 给 rootView 变量 保存 起 来 。 在 onCreateView 中 为 rootView 事件 设置 点 击 事件 。 


Private View rootView; 
Private View.OnClickListener onClickListener; 





public void setOnClickListener (View.OnClickListener onClickListener) { 
this.onClickListener = onClickListener; 


) 


Q@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
Log.i("FragmentOne","onCreate"); 


@Override 
Public View onCreateView (LayoutInflater inflater,ViewGroup 
container,Bundle savedInstanceState) { 
Log.i("FragmentOne","onCreateView"); 
rootView=inflater.inflate(R.layout.fragment one,null); 
return rootView; 


@Override 

Public void onActivityCreated (Bundle savedInstanceState) { 
super.onActivityCreated (savedInstanceState); 
Log.i("FragmentOne","onActivityCreated"); 
if(onClickListener!=null){ 

rootView.setOnClickListener (onClickListener); 

} 

h 


MainActivity 修改 比较 简单 ， 在 onCreate 方法 中 增加 了 如 下 代码 ， 获 取 静 态 的 Fragment， 然后 
注入 点 击 事件 ， 这 样 最 终点 击 Fragment 时 就 会 调用 onClick 方法 。 


staticFragment= (FragmentOne) getSupportFragmentManager () . 
findFragmentById (R.id.fragment one); 

staticFragment .setOnClickListener (new View.OnClickListener() { 

@Override 

public void onClick(View v) { 

Log.i("MainActivity", "动态 加 载 的 Fragment 被 点 击 了 "); 

1 

yh» 


4.6 ”Fragment 案例 一 一 实现 底部 导航 栏 


底部 导航 栏 在 App 开发 中 是 经 常 碰 到 的 。 国 内 的 App 大 部 分 都 有 底部 导航 栏 〈 例 如 QQ、 微 
信 、 支 付 宝 ) ， 以 便 用 户 随 时 切换 界面 、 查 看 不 同 的 内 容 。 
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Android 原生 操作 系统 (从 nexus 系列 到 pxiel 系列 ) 会 预 装 很 多 Google 自 带 的 App。Google 
推荐 用 侧 滑 菜单 ， 但 是 YouTube 跟 相 册 这 两 款 App 却 都 使 用 了 底部 导航 栏 。 底 部 导航 栏 的 实现 方 
式 有 很 多 种 ， 本 节 将 用 TextView+Frgment 方式 来 实现 底部 导航 栏 。 这 种 方式 的 优点 是 修改 方便 、 
实现 简单 。 


4.6.1 分 析 需 求 


效果 图 如 图 4-3 和 图 4-4 所 示 。 图 4-3 是 App 刚 启 动 时 的 效果 ， 从 中 可 以 看 到 底部 有 四 个 tab 
(首页 、 动态 、 消 息 、 我 ) ， 点 击 某 个 Tab 之 后 会 显示 Tab 对 应 的 Fragment。 图 4-4 就 是 点 击 底部 
Tab“ 我 ”之 后 的 效果 。 四 个 Tab 中 间 还 有 一 个 图 片 ， 点 击 这 个 图 片 之 后 直接 跳 转 到 Activity。 实 
现 的 具体 细节 如 下 : 
@ 底部 Tab 在 屏幕 中 的 宽度 是 一 致 的 ， 应 该 想到 LinearLayout 的 weight 属性 ， 利 用 线性 布局 的 
权重 。 
@ 中 间 的 图 片 突出 了 一 点 点 ， 考 虑 在 最 外 层 用 RelativeLayout 或 者 FrameLayout， 因 为 
FrameLayout 灵活 性 没有 RelativeLayout 强 ， 所 以 优先 选择 RelativeLayout。 
点 击 tab 之 后 底部 导航 栏 文字 颜色 图 片 都 有 变化 。 用 淡 绿 代表 选中 ， 灰 色 代 表 不 选中 。 
Tab 点 击 之 后 内 容 区 域 变 化 ， 需 要 切换 Fragment 显示 。 
[5 人 1156| 


这 是 首页 这 是 个 人 中 心 页 面 





图 43 App 启动 显示 首页 图 4-4 点 击 底部 Tab“ 我 ”之 后 的 效果 


4.6.2 ”代码 实现 


先 看 布局 文件 activity_main .xml: 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match Parent" 
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android:layout height="match parent" > 


<FrameLayout 
android:id="@+id/main container" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout above="@+id/view line"/> 


<View 
android:id="@+id/view line" 
android:layout height="ldp" 
android:layout width="match parent" 
android:background="#DCDBDB" 
android:layout above="@+id/rl bottom"/> 





<LinearLayout 
android:id="@+id/rl bottom" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:paddingTop="5dp" 
android:paddingBottom="5dp" 
android:background="#F2F2F2" 
android:orientation="horizontal" > 


<TextView 
android:id="@+id/tv main" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout weigh 下 
android:drawableTop="@drawable/tab item main img selector" 
android:drawablePadding="@dimen/main tab item image and text" 
android:focusable="true" 
android:gravity="center" 
android:text="@string/main" 
android:textColor="@drawable/tabitem txt sel" /> 














<TextView 
android:id="@+id/tv dynamic" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout weight="1" 
android:drawableTop="@drawable/tab item dynamic img selector" 
android:drawablePadding="@dimen/main tab item image and text" 
android:focusable="true" 
android:gravity="center" 
android:text="@string/dynamic™" 
android:textColor="@drawable/tabitem txt sel" /> 














<View 
android:layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1" /> 
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<TextView 
android:id="@+id/tv message" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout weight="1" 
android:drawableTop="@drawable/tab item message img selector" 
android:drawablePadding="@dimen/main tab item image and text" 
android:focusable="true" 
android:gravity="center" 
android:text="@string/message" 
android:textColor="@drawable/tabitem txt sel" /> 


<TextView 
android:id="@+id/tv person" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout weight="1" 
android:drawableTop="@drawable/tab item person img selector" 
android:drawablePadding="@dimen/main tab item image and text" 
android:focusable="true" 
android:gravity="center" 
android:text="@string/person" 
android:textColor="@drawable/tabitem txt sel"/> 
</LinearLayout> 


<ImageView 

android:id="@+id/iv make" 

android:layout width="wrap content" 

android:layout height="wrap content" 

android:layout alignParentBottom="true" 

android:layout centerHorizontal="true" 

android:paddingBottom="10dp" 

android:src="@drawable/icon tab make select"/> 
</RelativeLayout> 


最 外 层 用 RelativeLayout。 


第 一 个 子 View 是 FrameLayout，tab 切换 的 时 候 用 它 来 显示 Fragment。 

第 二 个 View 就 是 一 个 分 割 线 。 

第 三 个 View 是 一 个 LinearLayout, 设置 了 android:layout_alignParentBottom="true", 在 父 View 
的 底部 显示 ， 里 面 有 4 个 TextView 跟 一 个 View， 权 重 都 是 1， 但 是 最 中 间 那 个 没有 内 容 ， 是 
一 个 室 的 View， 只 是 用 它 在 来 占 一 个 位 置 。 

@ 第 4 个 View 是 一 个 ImageView， 也 设置 了 android:layout alignParentBottom 属性 ， 并 且 通 过 
android:layout_centerHorizontal 属性 设置 水 平 居中 , 在 RelativeLayout 里 面 如 果 两 个 View 在 同 
一 个 位 置 上 ， 后 面 的 View 就 会 覆盖 之 前 的 View， 所 以 这 个 ImageView 盖 住 了 LinearLayout 
最 中 间 的 那个 View。 


从 布局 文件 中 我 们 看 到 给 每 个 TextView 设置 了 android:drawableTop 属性 ， 这 个 属性 就 是 在 
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TextView 的 文本 上 面 放 一 张 图 片 。android:drawableTop 属性 对 应 的 是 一 个 drawable 文件 ， 这 么 做 
的 目的 就 是 把 选中 跟 未 选中 状态 的 图 标 都 表示 出 来 。 最 外 层 是 一 个 selector, 里 面 有 两 个 item (item 
可 以 有 多 个 ) ， 第 一 个 item 是 选中 状态 的 情况 ，item 有 一 个 属性 叫 android:state_selected="true"， 
就 是 View 选中 状态 时 显示 android:drawable 对 应 的 图 片 。 第 二 个 item 是 默认 情况 ， 就 是 非 选中 的 
情况 显示 。 在 Java 代码 中 调用 TextView.setSelected (true) 对 应 第 一 个 item。 


<?xml Version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 选中 状态 显示 --> 
<item android:drawable="@drawable/icon tab main select" 
android:state selected="true"/> 


<!-- 非 选中 状态 显示 --> 
<item android:drawable="@drawable/icon tab main normal"/> 
</selector> 


不 只 是 图 片 ， 还 有 TextView 设置 文字 颜色 也 是 通过 selector 来 控制 的 。 我 们 可 以 看 到 底部 四 
个 TextView 的 android:textColor 属性 都 引用 了 drawable/tabitem_txt_sel 文件 。 跟 图 片 的 选择 器 有 点 
类 似 ， 只 不 过 把 android:drawable 换 成 了 android:color。 
<?xml version="1.0" encoding="utf-8"?> 
<selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<!-- 选中 状态 --> 


<item android:color="@color/main tab item text select" 
android:state selected="true"/> 


<!-- 非 选中 状态 --> 
<item android:color="@color/main tab item text normal"/> 
</selector> 


接 下 来 看 MainActivity 代码 , 继承 自 FragmentActivity， 这 是 android-support-v4.jar 包 里 面 的 
个 类 ， 可 以 兼容 3.0 以 下 版 本 使 用 Fragment。 


public class MainActivity extends FragmentActivity { 
// 要 切换 显示 的 四 个 Fragment 
private HomeFragment homeFragment; 
Private DynamicFragment dynamicFragment; 
Private MessageFragment messageFragment; 
Private PersonFragment personFragment; 


private int currentId = R.id.tv main;// 当前 选中 id, 默认 是 主页 
private TextView tvMain, tvDynamic, tvMessage, tvPerson;// 底 部 四 个 TextView 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 


tvMain = (TextView) findViewById(R.id.tv main); 
tvMain.setSelected (true) ;// 首 页 默认 选中 

tvDynamic = (TextView) findViewById(R.id.tv dynamic) 
tvMessage = (TextView) findViewById(R.id.tv message); 
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tvPerson = (TextView) findViewById(R.id.tv Person) 


// 默 认 加 载 首页 

homeFragment = new HomeFragment () 7 

getSupportFragmentManager () .beginTransaction() .add (R.id. 
main container, homeFragment) .commit (); 


tvMain.setOnClickListener (tabClickListener); 

tvDynamic.setOnClickListener (tabClickListener); 

tvMessage.setOnClickListener (tabClickListener); 

tvPerson.setOnClickListener (tabClickListener); 

findViewById(R.id.iv make) .setOnClickListener(onClickListener); 
| 


Private OnClickListener onClickListener=new OnClickListener() { 
Goverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.iv make: 
Toast .makeText (MainActivity.this, "点击 了 制作 按钮 "， 
Toast .LENGTH SHORT) .show(); 
break; 


private OnClickListener tabClickListener = new OnClickListener() { 
@Override 
Public void onClick(View v) { 
if (v.getId() != currentId) {// 如 果 当 前 选中 跟 上 次 选中 的 一 样 ,不 需要 处 理 
changeSelect (v.getId() ) ; // 改 变 图 标 跟 文字 颜色 的 选中 
changeFragment (v.getId() ) ;//fragment 的 切换 
currentId = v.getId();// 设 置 选中 id 


/x 
* 改变 fragment 的 显示 
* @param resId 
Private void changeFragment (int resId) { 
FragmentTransaction transaction = getSupportFragmentManager (). 
beginTransaction () ;// 开 启 一 个 Fragment 事务 


hideFragments (transaction) ;// 隐 藏 所 有 fragment 
if(resId==R.id.tv main) {// 主 页 
if (homeFragment==nul1) {// 如 果 为 空 先 添加 进来 ， 不 为 空 则 直接 显示 
homeFragment = new HomeFragment (); 
transaction.add(R.id.main container,homeFragment); 
}else { 
transaction.show (homeFragment); 
i 
}else if(resId==R.id.tv dynamic) {// 动 态 
if (dynamicFragment==null1) 1{ 
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} 


a 


dynamicFragment = new DynamicFragment (); 
transaction.add(R.id.main container,dynamicFragment); 
Helse { 
transaction.show (dynamicFragment); 
bE 
}else if(resId==R.id.tv message) {// 消 息 中 心 
if (messageFragment==nul1){ 
messageFragment = new MessageFragment (); 
transaction.add(R.id.main container,messageFragment); 
}else { 
transaction.show (messageFragment); 
. 
}else if(resId==R.id.tv person){// 我 
if(personFragment==nul11){ 
personFragment = new PersonFragment (); 
transaction.add(R.id.main container,personFragment); 
}else { 
transaction.show (personFragment); 
} 
} 
transaction.commit ();// 一 定 要 记得 提交 事务 


* 显示 之 前 隐藏 所 有 fragment 


* @param transaction 


ef 


Private void hideFragments (FragmentTransaction transaction){ 


} 


PS 


if (homeFragment != nul1) // 不 为 空 才 隐藏 , 如 果 不 判断 第 一 次 会 有 空 指针 异常 


transaction.hide (homeFragment) 7 
if (dynamicFragment != null) 
transaction.hide (dynamicFragment); 


if (messageFragment != null) 
transaction.hide (messageFragment); 
if (personFragment != null) 


transaction.hide (personFragment); 


* 改变 TextView 选中 颜色 


* @param resId 


Private void changeSelect (int resId){ 


tvMain.setSelected (false); 

tvDynamic.setSelected (false); 
tvMessage.setSelected (false); 
tvPerson.setSelected(false); 


Switch (resId) { 

case R.id.tv main: 
tvMain.setSelected (true); 
break; 

case R.id.tv dynamic: 
tvDynamic.setSelected (true); 
break; 
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case R.id.tv message: 
tvMessage .setSelected (true) 
break; 

case R.id.tv person: 
tvPerson.setSelected (true); 
break; 


} 


首先 在 onCreate 方法 中 设置 布局 文件 ,查找 底部 的 四 个 TextView, 给 首页 的 TextView 设置 为 
选中 状态 ， 并 且 默 认 加 载 首 页 的 Fragment， 最 后 给 底部 的 四 个 Tab 设置 点 击 事件 。 还 有 最 中 间 的 
那个 ImageView 。 

tabClickListener 处 理 Tab 点 击 事件 ， 先 判断 这 次 点 击 的 Tab 跟 上 次 点 击 的 是 否 一 致 ， 如 果 跟 
当前 的 是 一 样 的 就 不 需要 处 理 ， 和 否则 的 话 需 要 改变 图 标 跟 文字 选中 状态 ， 还 有 Fragment 的 切换 ， 
并 且 把 当前 点 击 View 的 id 设置 成 当前 选中 的 id。 

changeSelect 方法 改变 TextView 选中 颜色 ， 首 先 全 部 设置 成 未 选中 ， 然 后 判断 当前 选中 的 哪个 。 

changeFragment 改变 Fragment 的 显示 ,首先 调用 hideFragments 方法 隐藏 所 有 的 Fragment， 然 
后 根据 当前 选中 的 Tab 来 决定 显示 哪个 Fragment。 显 示 的 时 候 需要 先 判断 这 个 Fragment 有 没有 显 
示 过 ， 如 果 没 有 显示 过 需要 新 建 一 个 新 的 Fragment， 然 后 调用 FragmentTransaction 的 add 方法 添 
加 进去 。 如 果 之 前 有 添加 过 的 ， 直 接 调用 show 方法 就 行 。 

hideFragments 方法 就 是 隐藏 所 有 的 Fragment。 先 判断 Fragment 是 否 为 null， 不 为 null 就 调用 
transaction.hide 方法 隐藏 Fragment。 

底部 的 四 个 Tab (TextView) 对 应 四 个 Fragment， 分 别 是 HomeFragment、DynamicFragment、 
MessageFragment、PersonFragment。 因 为 是 Demo， 所 以 都 只 显示 了 一 个 TextView。 我 们 看 看 首页 
的 Fragment， 其 他 三 个 就 不 贴 代码 了 。 

HomeFragment 显示 的 是 布局 文件 fragment_home.xml， 里 面 只 有 一 个 TextView。 





<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match Parent"> 
<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:text=" 这 是 首页 " 
android:textSize="20sp"/> 
</RelativeLayout> 
HomeFragment .java 
Public class HomeFragment extends Fragment{ 
@Override 
Public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View rootView = inflater.inflate(R.layout.fragment home, null); 
return rootView; 
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4.7 本章 小 结 





本 章 重点 介绍 了 Fragment 的 使 用 方法 。 将 Fragment 单独 拿 出 来 讲解 ， 足 以 说 明 其 重要 性 。 本 
章 主要 学 习 了 Fragment 的 生命 周期 , Activity 如 何 通过 FragmentManager 与 FragmentTransaction 这 
两 个 类 来 管理 Fragment， 以 及 Activity 管理 的 多 个 Fragment 之 间 如 何 交 互 数 据 。 最 后 用 
TextView+Fragment 实现 底部 导航 栏 ， 让 大 家 更 熟练 地 使 用 Fragment。 底 部 导航 栏 也 是 现在 主流 
App 的 一 种 展示 方式 。 








第 吕 章 


Android 多 线程 开发 


本 章 学 习 了 在 Android 中 如 何 创 建 多 线程 、 多 线程 中 更 新 UI, 用 Handler 方式 实现 两 个 线程 之 
间 的 通信 ， 同 时 从 源码 的 角度 学 习 了 Handler 的 实现 原理 (Handler、Looper 与 MessageQueue 三 者 
的 关系 )， 还 使 用 了 系统 给 我 们 封装 的 AsyncTask 异步 任务 处 理 类 ,最 后 学 习 了 线程 池 的 使 用 ， 有 
多 个 异步 任务 时 ， 合 理 地 使 用 线程 池 会 减少 系统 资源 的 使 用 ， 增 加 程序 的 流畅 性 。 


5.1 多 线程 的 创建 


每 个 应 用 启动 时 ，Android 会 启动 一 个 对 应 的 主线 程 来 处 理 UI 相关 的 事情 ， 例 如 用 户 的 按键 
事件 、 用 户 接触 屏幕 的 事件 以 及 屏幕 绘图 事件 ， 并 且 把 相关 的 事件 分 发 到 对 应 的 组 件 进行 处 理 ， 所 
以 主线 程 通常 又 称 为 UI 线程。 

如 果 比 较 耗 时 的 任务 〈 例 如 下 载 文件 ) 也 在 主线 程 完成 ， 就 会 影响 用 户 体验 ， 会 阻塞 主线 程 ， 
这 种 情况 下 就 需要 创建 一 个 子 线程 ， 把 耗 时 任务 放 在 子 线程 中 执行 。 

在 Android 中 创建 一 个 线程 与 在 Java 中 创建 线程 是 一 样 的 。 首 先 在 MainActivity 的 onCreate 
中 增加 如 下 代码 : 


new Thread (new Runnable(){ 
@Override 
Public void run(){ 
for (int i=1;i<=100;i++){ 
Log.i("MainActivity", "当前 值 是 :"+i); 
try { 
Thread.sleep (200); 
} catch (InterruptedException e) { 
e.printStackTrace (); 
1 
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} 
hearen 
这 里 开启 了 一 个 线程 ,在 线程 中 写 了 一 个 for 循环 100 次 , 然后 打印 当前 的 值 ， 并 且 每 次 循环 

时 设置 了 延迟 200 毫秒 。 

运行 软件 ， 可 以 看 到 打印 的 日 志 如 下 : 
02-19 08:07:14.952 20477-20497/com.ansen.multithread I/MainActivity: 当前 值 是 :1 
02-19 08:07:15.160 20477-20497/com.ansen.multithread I/MainActivity: 当前 值 是 :2 
02-19 08:07:15.360 20477-20497/com.ansen.multithread I/MainActivity: 当前 值 是 :3 


02-19 08:07:34.824 20477-20497/com.ansen.multithread I/MainActivity: 当前 值 是 :100 


5.2 子 线 程 中 更 新 UI 的 四 种 方法 


在 Android 开发 中 ， 子 线程 是 不 能 直接 更 新 UI 界面 的 ， 如 果 在 子 线程 中 操作 UI， 程序 就 会 前 
溃 ， 并 且 抛 出 以 下 异常 

android.view.ViewRootImpl$CalledFromWrongThreadException: Only the original 
thread that created a view hierarchy can touch its views. 

at android.view.ViewRootImpl.checkThread (ViewRootImpl .java:6024) 

at android.view.ViewRootImpl .requestLayout (ViewRootImpl .java:820) 

-种 常用 的 处 理 方法 就 是 在 子 线程 中 执行 耗 时 任务 ， 执 行 完成 之 后 发 送 消息 给 主线 程 ， 通 知 
主线 程 更 新 界面 。 例如， 下 载 文件 ， 开 启 一 个 子 线 程 去 下 载 ， 下 载 完成 之 后 发 送 一 个 消息 通知 主线 
程 更 新 界面 ， 提 示 用 户 文件 已 下 载 完成 。 

在 Android 中 子 线程 更 新 UI 的 方法 有 以 下 四 种 : 
用 Activity 对 象 的 rmOnUiThread 方法 。 
View.post ( Runnable r ). 
AsyncTask 系统 SDK 提供 的 处 理 耗 时 任务 的 类 。 
Handler 解决 多 线程 间 的 通信 。 


上 面 介绍 了 子 线程 中 更 新 UI 的 四 种 方法 ， 其 实 前 面 三 种 方式 的 底层 原理 也 是 通过 Handler 实 
现 的 。AsyncTask 与 Handler 两 种 方法 放 到 本 章 后 面 单独 讲解 。 这 里 先 学 习 前 面 两 种 方法 。 


5.2.1 用 Activity 对 象 的 runOnUiThread 方法 


新 建 一 个 项 目 ， 修 改 activity_main.xml 文件 ， 内 容 如 下 : 


<?xml] version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 
android:padding="10dp"> 
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<TextView 
android:id="@+id/tv content" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Hello World!" /> 
</LinearLayout> 


布局 文件 简单 ， 最 外 层 是 LinearLayout， 包 含 一 个 TextView。 

接着 修改 MainActivity.java 文件 ， 在 onCreate 方法 中 通过 id 查找 TextView， 再 开启 一 个 子 线 
程 ， 在 子 线程 的 run 方法 中 调用 Activity 的 runOnUiThread 方法 ，runOnUiThread 方法 需要 传 入 一 
个 Runnable 对 象 ， 用 内 部 类 的 方式 实现 Runnable 重 写 run 方法 ， 然 后 在 Runnable 的 run 方法 中 更 
新 UI 界面 。 


@Override 
Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout .activity main); 
tvContent=findViewById(R.id.tv content); 
new Thread(){ 
@Override 
Public void run() { 
// 用 activity 的 runonUiThread 方法 更 新 ui 底层 也 是 handler 实现 
runonUiThread (new Runnable() { 
@Override 
Public void run() { 
tvContent.setText ("runOonUiThread 更 新 ui"); 
1 
}) 7 
} 
}.start (); 


当代 码 执行 到 Runnable 的 run 方法 时 ， 其 实 当 前 线程 就 已 经 是 主线 程 了 , 我 们 继续 修改 代码 ， 
在 三 个 地 方 打 印 线程 id， 修 改 后 代码 如 下 : 


@Override 
Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 
setContentView(R.layout .activity main); 
tvContent=findViewById(R.id.tv content); 
Log.i ("MainActivity", "主线 程 id:"+android.os.Process.myTid()); 
new Thread(){ 
@Override 
Public void run() { 
Log.i("MainActivity", " 子 线程 id:"+android.os.Process.myTid()); 
// 用 activity 的 runonUiThread 方法 更 新 ui 底层 也 是 handler 实现 
runOonUiThread (new Runnable() { 
Qoverride 
Public void run() { 
Log.i("MainActivity", "主线 程 
id:"+tandroid.os.Process.myTid()); 
tvContent.setText ("runOnUiThread 更 新 ui"); 
} 
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DD); 
} 
Feetawedt)y 
} 
打印 log 如 下 ， 从 log 中 可 以 看 到 onCreate 中 的 线程 id 跟 Runnable 中 run 方法 打印 的 线程 id 
是 一 致 的 。 
05-01 11:39:58.100 2026-2026/? I/MainActivity: 主线 程 id:2026 


05-01 11:39:58.100 2026-2040/? I/MainActivity: 子 线程 id:2040 
05-01 11:39:58.108 2026-2026/? I/MainActivity: 主线 程 id:2026 


5.2.2 ”View.post 的 使 用 


同样 开启 一 个 子 线程 ， 在 子 线程 中 调用 要 更 新 的 控件 的 Post 方法 。 传 入 一 个 Runnable 对 象 ， 
在 Runnable 对 象 的 run 方法 中 更 新 UI。 


new Thread(){ 
@Override 
public void run() { 
tvContent.post (new Runnable() { 
@Override 
public void run() { 
tvContent .setText ("View Post 方式 "); 


1 
和 
} .start() 7 


5.3 ”Handler 的 使 用 


Handler 可 以 发 送 和 处 理 消息 对 象 或 Runnable 对 象 ， 这 些 消息 对 象 和 Runnable 对 象 与 一 个 线 
程 相关 联 。 每 个 Handler 的 实例 都 关联 了 一 个 线程 和 线程 的 消息 队列 。 当 创建 了 一 个 Handler 对 象 
时 ， 一 个 线程 或 消息 队列 同时 也 被 创建 ， 该 Handler 对 象 将 发 送 和 处 理 这 些 消息 或 Runnable 对 象 。 

Handler 类 有 两 种 主要 用 途 : 

@ 执行 Runnable 对 象 ， 还 可 以 设置 延迟 。 

@ ”两 个 线程 之 间 发 送 消息 ， 主 要 用 来 给 主线 程 发 送 消 息 更 新 UI。 





5.3.1 为 什么 要 用 Handler 


解决 多 线程 并 发 问题 ， 假 设 如 果 在 一 个 Activity 中 有 多 个 线程 去 更 新 UI， 并 且 都 没有 加 锁 机 
制 ， 那 么 界面 显示 肯定 会 不 正常 。 因 此 ，Android 官方 就 封装 了 一 套 更 新 UI 的 机 制 ， 也 可 以 使 用 
Handler 来 实现 多 个 线程 之 间 的 消息 发 送 。 
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5.3.2 使 用 Handler 


Handler 常用 的 方法 如 下 : 


post (Runnable )。 

postAtTime (Runnable，long )。 
postDelayed ( Runnable，long )。 
sendEmptyMessage (int )。 
sendMessage ( Message )。 
sendMessageAtTime (Message, long )。 


sendMessageDelayed (Message, long )。 
这 些 方法 主要 分 为 两 类 : 一 类 是 传 入 一 个 Runnable 对 象 ， 另 一 类 是 传 入 一 个 Message 对 象 。 
1. 用 代码 学 习 Post 一 个 Runnable 对 象 
先 创 建 Handler 对 象 ， 直 接 新 建 即 可 : 
private Handler Handler=new Handler(); 
实现 Runnable 接口 ， 使 用 匿名 实现 方式 ， 重 写 run 方法 ， 打 印 一 个 字符 串 。 
Private Runnable runnable=new Runnable() { 
@Override 
Public void run() { 
Log.i("MainActivity","Handler Runnable"); 
由 
] 7 
然后 调用 Handler 的 Post 方法 。 这 里 需要 注意 的 是 ，Post 一 个 Runnable 对 象 ， 底 层 用 的 是 回 
调 ， 不 会 开启 一 个 新 的 线程 。 所 有 Runnable 的 run 方法 还 是 在 主线 程 中 ， 是 可 以 更 新 UI 的 。 
Handler.post (runnable) ;// 执 行 
Handler.postDelayed (runnable,2000) ;// 延 迟 2 秒 后 执行 
运行 程序 ， 控 制 台 打印 的 日 志 如 下 : 
05-18 19:17:14.901 17750-17750/com.ansen.Handler I/MainActivity: Handler Runnable 
05-18 19:17:16.901 17750-17750/com.ansen.Handler I/MainActivity: Handler Runnable 
从 上 面 的 日 志 中 可 以 看 到 两 条 日 志 的 时 间 相 差 两 秒 。 这 是 因为 用 postDelayed 方法 时 ， 第 二 个 
参数 设置 了 两 秒 的 延迟 。 
2. 使 用 sendMessage 方法 发 送 消息 
sendMessage 方法 可 以 理解 为 用 来 发 送 消息 ， 这 种 方法 在 Android 中 使 用 频率 比较 高 。 因 为 在 
Android 多 线程 中 是 不 能 更 新 UI 的 ， 所 以 必须 通过 Handler 把 消息 发 送 给 UI 线程 ， 才 能 更 新 UI。 
当然 ， 也 可 以 用 Handler 实现 两 个 子 线程 发 送 消 息 。 
新 建 一 个 项 目 ， 给 activity_main.xml 文件 中 的 TextView 控件 设置 一 个 id。 


<?xml] version="1.0" encoding="utf-8"?> 
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<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 


android:layout height="match parent"> 


<TextView 
android:id="@+id/textview" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Hello World!" /> 
</RelativeLayout> 





继续 修改 MainActivity.java 代码 : 


Public class MainActivity extends AppCompatActivity { 

Private TextView textview; 
Public static final int UPDATE UI=17 
Private Handler handler=new Handler(){ 

@Override 

Public void handleMessage (Message msg) { 

if (msg.what==UPDATE UI){ 
textview .setText ("当前 值 是 : "+msg .obj); 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout .activity main); 


textview= (TextView) findViewById(R.id.textview); 
new Thread (new Runnable(){ 
@Override 
Public void run(){ 
for(int i=1;i<=100;i++){ 
Log.i("MainActivity", "当前 值 是 : "+i); 
Message message=handler.obtainMessage(); 
message.what=UPDATE UI; 
message .obj=i; 
handler .sendMessage (message); 
try { 
Thread.sleep (200); 
} catch (InterruptedException e) { 
e.printStackTrace (); 
} 
1 
} 
}) .start (); 


'’ 


首先 用 内 部 类 方式 新 建 一 个 Handler 对 象 ， 重 写 handleMessage 方法 ， 在 handleMessage 方法 
中 先 判 断 传 入 过 来 的 Message 对 象 中 what 的 值 是 不 是 我 们 定义 的 常量 UPDATE_UI 的 值 ， 如 果 是 
就 更 新 ui， 把 obj 对 象 的 值 加 上 字符 串 赋值 给 TextView。 


202 | Android App 开发 从 入 门 到 精通 





接 下 来 看 onCreate 方法 ， 根 据 id 查找 TextView 控件 ， 然 后 开启 一 个 子 线程 ， 在 子 线程 的 run 
方法 中 用 了 一 个 for 循环 ， 循 环 100 次 ， 在 循环 体 中 ， 首 先 调用 handler.obtainMessage() 获 取 一 个 
Message 对 象 , 该 方法 是 从 消息 池 中 返回 一 个 Message 对 象 , 只 有 消息 池 中 没有 时 才 会 创建 Message 
对 象 。Message 对 象 的 what 属性 是 必须 要 赋值 的 , 是 一 个 int 类 型 。 这 里 我 们 赋值 自己 定义 的 常量 ， 
当 Handler 接收 到 这 个 Message 时 也 是 赁 这 个 值 来 区 分 消息 从 哪里 来 的 , Message 对 象 还 有 一 个 obj 
属性 ，obj 属性 用 来 传递 参数 ， 这 是 一 个 Object 类 型 ， 这 里 我 们 传 入 i 的 值 ， 然 后 调用 
handler.sendMessage (message ) 方法 。 当 sendMessage 方法 调用 之 后 Handler 的 handleMessage 方 
法 就 会 回调 (更 新 ui) ， 最 后 调用 Thread.sleep 〈200) 延迟 200 毫秒 。 

运行 代码 ， 每 200 毫秒 更 新 一 次 界面 ， 一 共 更 新 100 次 ，for 循环 结束 ， 子 线程 退出 。 


5.3.3 Handler、Looper 与 MessageQueue 三 者 的 关系 


前 面 已 对 Handler 进行 介绍 ， 也 讲解 了 如 何 使 用 Handler， 但 是 并 不 知道 它 的 实现 原理 。 本 节 
从 源码 的 角度 来 分 析 是 如 何 实现 的 。 
首先 需要 知道 Handler、Looper 与 MessageQueue 三 者 之 间 的 关系 : 
Handler 封装 了 消息 的 发 送 ， 也 负责 接收 消息 。 内 部 会 与 Looper 关联 。 
Looper 封装 了 线程 中 的 消息 循环 ， 内 部 包含 了 MessageQueue， 负 责 从 MessageQueue 取出 消 
息 ， 然 后 交 给 Handler 处 理 。 
@ ”MessageQueue 就 是 一 个 消息 队列 ， 负 责 存储 消息 ， 收 到 消息 就 存储 起 来 ，Looper 会 循环 地 
从 MessageQueue 读 取消 息 。 
1. 源码 分 析 
当 新 建 一 个 Handler 对 象 时 ， 查 看 它 的 构造 方法 中 做 了 什么 。 默 认 的 无 参 构造 调用 了 自己 两 个 
有 参数 的 构造 方法 。 
Public Handler() { 


this(null, false); 
} 


继续 跟踪 两 个 有 参数 的 构造 方法 ， 第 一 个 参数 是 一 个 Callback 对 象 ， 用 来 拦截 消息 ， 后 面 讲 
dispatchMessage 方法 时 就 会 明白 ， 第 二 个 参数 用 于 说 明 是 否 异 步 。 


Public Handler(Callback callback, boolean async) { 
if (FIND POTENTIAL LEAKS) { 
final Class<? extends Handler> klass = getClass(); 
if ((klass.isAnonymousClass() || klass.isMemberClass() || 
klass.isLocalClass()) && (klass.getModifiers() & Modifier.STATIC) == 0) { 
Log.w(TAG, "The following Handler class should be static or leaks 
might occur: " + klass.getCanonicalName()); 
上 
} 


mLooper = Looper.myLooper (); 
if (mLooper == null) { 
throw new RuntimeException( 
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"Can't create Handler inside threadthat has not called Looper.Prepare ()") 


ji 

moueue = mLooper.mQueue; 
mCallback = callback; 
mAsynchronous = async; 


和 

在 构造 方法 中 会 调用 Looper.myLooper 方法 获取 一 个 Looper 对 象 , 然后 从 Looper 对 象 获取 到 
MessageQueue 对 象 。 

2. 了 解 Looper myLooper() 

Looper.myLooper() 是 一 个 静态 方法 ， 能 够 以 “类 名 .方法 名 ”的 形式 直接 调用 。 

public static @Nullable Looper myLooper() { 

return sThreadLocal.get (); 

i 

这 个 方法 中 就 有 一 行 代码 ， 从 sThreadLocal 中 获取 一 个 Looper 对 象 ，sThreadLocal 是 一 个 
ThreadLocal 对 象 ， 可 以 在 一 个 线程 中 存储 变量 。 底 层 是 ThreadLocalMap， 既 然 是 Map 类 型 肯定 
先 发 送 一 个 Looper 对 象 ， 然 后 才能 从 sThreadLocal 对 象 中 获取 一 个 Looper 对 象 。 

3. 了 解 ActivityThread main() 


说 到 这 里 ， 需 要 介绍 一 个 ActivityThread 新 类 。 它 是 Android App 进程 的 初始 类 ，main 函数 是 
App 进程 的 入 口 。 下 面 看 一 下 main 函数 。 


Public static final void main(String[] args) { 


Looper .PrepareMainLooper (); 

if (sMainThreadHandler == null) { 
sMainThreadHandler = new Handler(); 

上 


ActivityThread thread = new ActivityThread(); 
thread .attach (false); 


if (false) 1{ 
Looper .myLooper () .setMessageLogging (new 
LogPrinter (Log.DEBUG, "ActivityThread")); 
} 


Looper .loop(); 
在 第 2 行 代码 调用 了 Looper.prepareMainLooper() 方 法 ， 第 13 行 调用 了 Looperloop() 方 法 。 
4. 了 解 Looper prepareMainLooper() 


继续 跟 进 Looper.prepareMainLooper() 方 法 ,在 该 方法 中 第 一 行 代码 调用 了 内 部 的 prepare 方 法 。 
prepareMainLooper 有 点 类 似 单 例 模式 中 的 getInstance 方法 ， 只 不 过 getInstance 会 返回 一 个 对 象 ， 
而 prepareMainLooper 会 新 建 一 个 Looper 对 象 并 存储 在 sThreadLocal 中 。 


Public static void prepareMainLooper() { 
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Prepare (false); 
synchronized (Looper.class) { 
if (sMainLooper != null) { 
throw new IllegalStateException("The main Looper has already been 
prepared."); 
站 
sMainLooper = myLooper() 7 


5. 了 解 Looper prepare() 


继续 跟 进 prepare 方法 ， 查 看 第 5 行 代码 ， 新 建 了 一 个 Looper 对 象 ， 调 用 sThreadLocal.set 方 
法 将 Looper 对象 保 存 起 来 ,看 到 这 里 ,肯定 明白 了 为 什么 新 建 Handler 对 象 时 调用 Looper.myLooper() 
方法 能 够 从 sThreadLocal 对 象 中 获取 Looper 对 象 。 


Private static void Prepare (boolean quitAllowed) { 
if (sThreadLocal.get() != null) { 
throw new RuntimeException ("Only one Looper may be created Per thread"); 
} 
sThreadLocal.set (new Looper (quitAllowed)); 
} 


6. Looper 构造 方法 
本 章 开 头 讲 到 Looper 内 部 包含 了 MessageQueue， 其 实 就 是 在 新 建 Looper 对 象 的 同时 就 新 建 
了 一 个 MessageQueue 对 象 。 


Private Looper (boolean quitAllowed) { 
mQueue = new MessageQueue (quitAllowed); 
mThread = Thread.currentThread(); 

} 


7. 了 解 Looper loop() 
ActivityThread 类 main 方法 中 调用 了 Looper 的 两 个 方法 ,前 面 已 经 解释 了 prepareMainLooper() 
方法 ， 现 在 查看 第 二 个 方法 loop()。 


Public static void loop() { 
final Looper me = myLooper() ;// 获 取 Looper 对 象 
if (me == null) { 
throw new RuntimeException("No Looper; Looper.prepare() wasn't called 
on this thread."); 
| 
final MessageQueue queue = me.mQueue;// 从 Looper 对 象 获取 MessageQueue 对 象 


// Make sure the identity of this thread is that of the local process, 
// and keep track of what that identity token actually is. 
Binder.clearCallingIdentity(); 

final long ident = Binder.clearCallingIdentity(); 


for (;;) {// 死 循环 ,一 直 从 MessageQueue 中 遍历 消息 
Message msg = queue.next(); // might block 
if (msg == null) { 
return; 


} 
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// This must be in a local variable, in case a UI event sets the logger 
final Printer logging = me.mLogging; 
if (logging != null) { 
logging.println(">>>>> Dispatching to " + msg.target + " "+ 
msg.callback + ": " + msg.what); 
} 


final long traceTag = me.mTraceTag; 
if (traceTag != 0 && Trace.isTagEnabled(traceTag)) { 
Trace.traceBegin(traceTag, msg.target.getTraceName (msg)); 
} 
try { 
// 调 用 Handler 的 dispatchMessage 方法 ， 将 消息 交 给 Handler 处 理 
msg.target.dispatchMessage (msg); 
} finally { 
if (traceTag != 0) { 
Trace.traceEnd (traceTag); 
直 
} 


if (logging != null) { 
logging.println("<<<<< Finished to " + msg.target + " "+ 
msg.callback); 
} 


// Make sure that during the course of dispatching the 

// identity of the thread wasn't corrupted. 

final long newIdent = Binder.clearCallingIdentity(); 

if (ident != newIdent) { 

Log.wtf (TAG, "Thread identity changed from 0x" 

+ Long.toHexString(ident) + " to Ox" 
+ Long.toHexString (newIdent) + " while dispatching to " 
+ msg.target.getClass().getName() + " " 
+ msg.callback + " what=" + msg.what); 


msg.recycleUnchecked(); 


ji 

这 个 方法 的 代码 比较 多 ， 给 代码 加 上 了 一 些 注释 。 其 实 就 是 一 个 死 循 环 ， 一 直 会 从 
MessageQueue 中 获取 消息 。 如 果 获 取 到 消息 ， 就 会 执行 msg.target.dispatchMessage(msg) 这 行 代码 ， 
msg.target 就 是 Handler， 也 就 是 调用 Handler 的 dispatchMessage 方法 ， 然 后 将 从 MessageQueue 中 
获取 的 消息 传 入 。 

8. Handler dispatchMessage() 方 法 

前 面 的 源码 分 析 中 ， 如 果 获 取 到 了 Message， 就 调用 Handler 的 dispatchMessage 方法 ， 
dispatchMessage 方法 对 消息 进行 最 后 处 理 ， 如 果 是 post 类 型 ， 就 调用 handlerCallback 方法 处 理 ， 
否则 是 sendMessage 发 送 的 消息 。 先 看 有 没有 拦截 消息 ， 如 果 没 有 ， 最 终 就 调用 handlerMessage 方 
法 进行 处 理 。 
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public void dispatchMessage (Message msg) { 
// 如 果 callback 不 为 空 ， 说 明 发 送 消息 时 是 发 送 一 个 Runnable 对 象 
if (msg.callback != null) { 
handlerCallback (msg); 
} else { 
if (mCallback != null) { // 这 是 用 来 拦截 消息 的 
if (mCallback.handlerMessage (msg)) { 
return; 
1 
handlerMessage (msg) ; // 最 终 调 用 重 写 的 HandlerMessage 方法 


} 
9. 了 解 Handler handlerCallback() 


看 到 这 里 就 应 该 知道 为 什么 发 送 一 个 Runnable 对 象 时 run 方法 执行 的 代码 在 主线 程 了 ， 因 为 
底层 根本 就 没有 开启 线程 ， 只 是 调用 了 run 方法 而 已 。 
private static void HandlerCallback (Message message) { 


message.callback.run(); 


} 


前 面 介绍 了 创建 Handler 对 象 、 创 建 Looper 以 及 创建 MessageQueue 的 整个 流程 。 现 在 分 析 一 
下 ， 当 调用 post 以 及 sendMessage 方法 时 如 何 将 消息 添加 到 MessageQueue。Handler post() 调 用 
getPostMessage 方法 ， 将 Runnable 传递 进去 。 

public final boolean post (Runnable r) 

| 


return sendMessageDelayed(getPostMessage(r), 0); 
} 


10. 了 解 Handler getPostMessage() 


首先 调用 Message.obtain() 方 法 , 取出 一 个 Message 对 象 , 然后 将 Runnable 对 象 赋值 为 Message 
对 象 的 callback 属性 。 看 到 这 里 , 也 应 该 明白 dispatchMessage 方法 为 什么 要 先 判断 callback 是 否 为 
二 和 
Private static Message getPostMessage (Runnable r) { 
Message m = Message.obtain(); 
m.callback = r; 
return m; 


} 
11. 了 解 Handler enqueueMessage() 


在 post 方法 中 调用 sendMessageDelayed 方法 ， 其 实 最 终 调用 的 是 enqueueMessage 方法 ， 所 以 
这 里 直接 看 enqueueMessage 方法 源码 。 第 一 行 代码 就 把 Handler 自己 赋值 给 Message 对 象 的 target 
属性 ， 然 后 调用 MessageQueue 的 enqueueMessage 方法 将 当前 的 Messgae 添加 进去 。 
Private boolean enqueueMessage (MessageQueue queue, Message msg, long 
uptimeMillis) { 
msg.target = this; 
if (mAsynchronous) { 
msg.setAsynchronous (true); 
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} 
return queue .enqueueMessage (msg，UPtimeMillis) 


12. 小 结 


通过 一 步 步 的 源码 跟踪 分 析 ， 相 信 读 者 对 Handler 的 实现 原理 有 了 更 深入 的 理解 。 一 句 话 做 一 
个 总 结 : Handler 负责 发 送 消息 , Looper 负责 接收 Handler 发 送 的 消息 , 并 直接 将 消息 回 传 给 Handler 
自己 。MessageQueue 就 是 一 个 存储 消息 的 容器 。 


5.4 使 用 AsyncTask 创建 后 台 线 程 


前 面 在 多 线程 中 更 新 UI， 用 Handler 类 来 发 送 消 息 ， 然 后 更 新 UI。 这 种 方式 对 于 整个 过 程 灵 
活 控制 ， 但 是 也 存在 缺点 ， 代 码 比 较 脓肿 。 当 多 个 任务 同时 执行 时 ， 不 易 对 线程 进行 精确 控制 。 

为 了 简化 操作 ，Android 1.5 提供 了 工具 类 android.os.AsyncTask， 在 代码 上 要 比 Handler 轻 量 
级 。AsyncTask 底层 是 一 个 线程 池 ， 执 行 多 任务 时 消耗 资源 较 少 。 

AsyncTask 定义 了 三 种 泛 型 类 型 : Params、Progress 和 Result。 

”Params: 启动 任务 需要 的 参数 ， 例 如 下 载 链接 地 址 。 

@ ”Progress: 执行 的 进度 。 

@ Result: 执行 结果 。 





AsyncTask 需要 重 写 以 下 四 个 方法 : onPreExecute 、doInBackground 、onProgressUpdate 和 


onPostExecute。 


onPreExecute: 执行 任务 之 前 调用 。 
doInBackground: 执行 任务 的 方法 ， 该 方法 是 多 线程 调用 ， 所 以 耗 时 操作 都 写 在 这 个 方法 中 ， 
通过 调用 publishProgress 方法 更 新 进度 。 

@ ”onProgressUpdate: 更 新 任务 进度 。 在 调用 publishProgress() 时 ， 这 个 方法 才 会 被 调用 ， 该 方 
法 可 以 直接 把 数据 更 新 到 UI 控件 上 。 

®@ ”onPostExecute: 任务 执行 完毕 调用 。 


上 面 说 了 这 么 多 的 理论 ， 想 必 听 得 也 是 一 头 雾 水 ， 直 接 贴 代码 来 查看 怎么 使 用 ， 我 们 模拟 从 
网 上 下 载 文件 。 


Private class DownloadFilesTask extends AsyncTask<String,Integer,Long> { 
@Override 
protected void onPreExecute() { 
Log.i("DownloadFilesTask", "执行 任务 之 前 ") ; 
上 


Protected Long doInBackground(String... url) { 
int count = url[0] .length () ;// 第 一 个 字符 串 
long totalSize = 0; 
for (int de Od < counts THe} 
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totalSize += i; 
publishProgress (i) ;// 执 行 此 方法 ,会 调用 onProgressUpdate 方法 更 新 下 载 进度 
// 如 果 取 消 就 结束 任务 


if (isCancelled()) break; 


} 


return totalSize; 


} 


protected void onProgressUpdate (Integer... 


progress){ 


Log.i("DownloadFilesTask"," 当前 下 载 进度 : "+Progress [0] .intValue()); 


} 


protected void onPostExecute (Long result) { 
Log.i("DownloadFilesTask", "下 载 完 成 :"+result); 


L 
| 


在 MainActivity 中 写 了 一 个 内 部 类 DownloadFilesTask 继承 AsyncTask。 定 义 泛 型 ， 重 写 方法 。 


接 下 来 在 onCreate 


中 调用 这 个 类 。 


new DownloadFilesTask() .execute ("www.downloadfile.com"); 


运行 代码 ， 查 看 打印 的 日 志 就 知道 代码 的 执行 顺序 。 


02-26 07:32:05. 
任务 之 前 
02-26 07:32:05. 


OQ2=26" 07:32305. 


02=26 07:32:05% 
下 载 进度 :18 

02=261072322052 
下 载 进度 :19 

02=26 07:32:05% 
完成 :190 


626 11871-11871/com.ansen. 
687 11871-11871/com.ansen. 


687 11871-11871/com.ansen. 


687 11871-11871/com.ansen. 
687 11871-11871/com.ansen. 


687 11871-11871/com.ansen. 


asynctask 
asynctask 


asynctask 


asynctask 
asynctask 


asynctask 


5.5 ”线程 池 的 使 用 


I/DownloadFilesTask: 
I/DownloadFilesTask: 


I/DownloadFilesTask: 


I/DownloadFilesTask: 
I/DownloadFilesTask: 


I/DownloadFilesTask: 


执行 
当前 
当前 


当前 
当前 
下 载 


线程 池 是 一 种 多 线程 处 理 形式 ， 处 理 过 程 中 将 任务 添加 到 队列 ， 然 后 在 创建 线程 后 自动 启动 


这 些 任务 。 


什么 情况 会 用 到 线程 池 呢 ? 假如 你 现在 做 一 个 音乐 
采用 下 面 的 代码 : 


耗 时 ， 需 要 启动 一 个 新 线程 进行 下 载 。 我 们 之 前 可 能 会 
new Thread (new Runnable(){ 
QOverride 
Public void run(){ 
// 下 载 歌 曲 


$ 
.start()s 


类 App， 用 户 需要 下 载 歌 曲 。 下 载 歌 曲 很 
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如 果 要 下 载 1000 首 歌 曲 ， 是 否 要 同时 开启 1000 个 线程 ? 这 样 会 产生 什么 问题 呢 ? 


每 下 载 一 首 歌 曲 ， 就 要 新 建 一 个 线程 ， 导 致 频繁 地 创建 线程 与 销毁 线程 ， 使 程序 卡 住 或 者 程 
序 前 溃 。 

这 样 创建 的 线程 没 法 统一 管理 。 

不 方便 统计 ， 例 如 已 下 载 完成 歌曲 的 数量 。 


如 果 使 用 线程 池 就 能 完美 地 解决 以 上 问题 。 线 程 池 的 优点 如 下 : 


重用 已 创建 线程 ， 不 会 频繁 创建 线程 与 销毁 线程。 
对 线程 统一 管理 、 分 配 、 调 优 和 监控 。 
控制 线程 数量 ， 合 理 使 用 系统 资源 。 这 样 不 会 造成 程序 卡 住 或 者 程序 前 溃 。 


Android 中 常用 的 线程 操作 都 是 通过 ThreadPoolExecutor 类 来 实现 的 ， 此 类 最 长 的 构造 方法 有 
7 个 参数 : 


Public ThreadPoolExecutor (int corePoolSize, 


int maximumPoolSize, 

long keepAliveTime, 

TimeUnit unit, 

BlockingQueue<Runnable> workQueue, 

ThreadFactory threadFactory, 

RejectedExecutionHandler handler) 
corePoolSize: 核心 线程 数 。 
maximumPoolSize: 线程 池 最 大 线程 数 。 
keepAliveTime: 线程 空闲 时 保持 时 间 。 如 果 线 程 池 中 线程 数量 超过 核心 线程 数量 ， 并 且 多 出 
的 线程 空闲 时 间 超 过 keepAliveTime, 就 会 结束 多 出 的 线程 , 从 而 及 时 销毁 多 出 来 的 空闲 线程 ， 
减少 资源 消耗 。 如 果 线 程 池 任务 增 多 ， 就 重新 创建 新 线程 。 这 个 参数 也 可 以 通过 
setKeepAliveTime(long, TimeUnit) 方 法 动态 设置 。 默 认 情况 下 ， 这 个 keepAliveTime 参数 针对 
的 是 非 核心 线程 。 如 果 调 用 allowCoreThreadTimeOut(boolean) 方 法 ， 传 入 true, keepAliveTime 
超时 策略 就 会 运用 在 核心 线程 上 。 
unit: 第 三 个 参数 的 单位 。 这 是 一 个 枚 举 ， 常 用 的 有 TimeUnit.SECONDS ( 秒 )， 具 体 还 有 以 
下 值 : 
> TimeUnit.DAYS (天 )。 
> TimeUnitHOURS (小 时 )。 
> TimeUnit.MICROSECONDS ( 徽 秒 )。 
> TimeUnit.MILLISECONDS (毫秒 ). 
> TimeUnit.MINUTES (分 钟 ). 
> TimeUnitNANOSECONDS ( 纳 秒 )。 
> TimeUnit.SECONDS ( 秒 )。 
workQueue: 线程 池 中 的 任务 队列 。 这 个 队列 保存 线程 池 提 交 的 任务 ， 它 的 使 用 与 线程 池 中 
的 线程 数量 有 关 ， 具 体 规 则 如 下 : 
> 如 果 当 前 的 线程 池 运行 的 线程 数 少 于 corePoolSize, 则 execute 方法 执行 任务 时 会 开启 一 个 


210 


Android App 开发 从 入 门 到 精通 





核心 线程 进行 处 理 。 

> 如 果 线 程 池 中 的 线程 数量 达到 核心 线程 数 ， 并 且 workQueue 未 满 ， 当 execute 方法 执行 任 
务 时 不 会 开启 新 线程 ， 而 是 将 任务 加 入 workQueue 队列 中 等 待 处 理 。 

> 当 execute 方法 执行 任务 时 ， 线 程 池 中 的 线程 数 已 达到 核心 线程 数 ， 并 且 workQueue 队列 
已 满 。 这 时 就 会 判断 线程 池 中 的 线程 数 是 否 大 于 maximumPoolSize， 如 果 没有 大 于 
maximumPoolSize， 就 会 开启 非 核心 线程 处 理 任务 ; 如 果 大 于 maximumPoolSize， 就 拒绝 
执行 该 任务 。 

BlockingQueue: 阻塞 队列 ， 有 以 下 三 个 常用 的 BlockingQueue 实现 类 。 

> SynchronousQueue: 一 种 无 缓冲 的 等 待 队列 ， 它 的 特别 之 处 在 于 内 部 没有 容器 ， 当 它 生 产 
产品 (put) 时 ， 如 果 当 前 没有 人 想 要 消费 产品 (当前 没有 线程 执行 take )， 此 生产 线程 必 
然 阻塞 ， 等 待 一 个 消费 线程 调用 take 操作 ，take 操作 将 会 唤醒 该 生产 线程 ， 同 时 消费 线 
程 会 获取 生产 线程 的 产品 (数据 传递 )， 这 样 的 一 个 过 程 称 为 一 次 配对 过 程 ( 当然， 也 可 
以 先 take 后 put， 原 理 是 一 样 的 )。 

> LinkedBlockingQueue: 无 界 队 列 。 调 用 execute 方法 执行 任务 ， 线 程 池 中 的 核心 线程 都 在 
运行 时 ,使 用 无 界 队 列 ( 例如 创建 时 没有 指定 大 小 ) 会 将 新 的 任务 加 入 inkedBlockingQueue 
中 等 待 执行 当然， 这 个 队列 创建 时 ， 构 造 方法 中 也 可 以 指定 大 小 。 

> ArrayBlockingQueue: 必须 要 指定 大 小 的 队列 ， 构 造 方法 要 传 入 一 个 int 类 型 参数 ， 设 置 队列 
的 大 小 。 存 储 在 ArrayBlockingQueue 中 的 元 素 按照 FIFO (先进 先 出 ) 的 方式 来 进行 存 取 。 

threadFactory: 创建 新 线程 的 工厂 类 ， 可 以 通过 Executors.defaultThreadFactory() 获 取 系 统 给 封 

装 的 线程 工厂 。 我 们 也 可 以 自己 手动 实现 一 个 ， 继 承 ThreadFactory 接口 ， 实 现 newThread 方法 。 

handler: 拒绝 任务 。 调 用 execute(Runnable) 方 法 提交 新 任务 时 ， 如 果 线 程 池 关 闭 或 者 线程 池 

线程 数量 等 于 maximumPoolSize 并 且 队 列 满 了 ，execute 内 部 就 会 调用 RejectedExecutionHandler 

接口 实现 类 的 rejectedExecution(Runnable, ThreadPoolExecutor) 方 法 。 


针对 拒绝 任务 ，SQK 提供 了 以 下 几 种 策略 : 


ThreadPoolExecutor.AbortPolicy: 添加 任务 被 拒绝 ， 这 是 默认 策略 ， 如 果 不 传递 handler 参数 ， 
默认 就 是 这 个 值 。 

ThreadPoolExecutor.CallerRunsPolicy: 提供 一 个 反馈 机 制 , 告诉 调用 者 可 以 减 慢 提交 新 任务 的 
速度 。 

ThreadPoolExecutor DiscardPolicy: 任务 无 法 执行 被 丢弃 。 
ThreadPoolExecutor.DiscardOldestPolicy: 如 果 线 程 池 没有 被 关闭 ， 委 弃 队 列 最 前 面 的 任务 ， 
然后 重新 尝试 执行 任务 (可 能 会 再 次 失败 ， 导 致 重 复 执 行 )。 


我 们 也 可 以 自 定 义 拒绝 策略 ， 编 写 一 个 类 实现 RejectedExecutionHandler 接口 ， 重 写 
rejectedExecution 方法 。 


Public static class MyRejectedExecutionHandler implements 
RejectedExecutionHandler { 


Public void rejectedExecution (Runnable r, ThreadPoolExecutor e) { 
throw new RejectedExecutionException ("任务 被 拒绝 "); 
} 
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学 习 了 这 么 多 理论 知识 ， 下 面 使 用 一 段 代码 进行 实践 : 
MyRejectedExecutionHandler handler=new MyRejectedExecutionHandler (); 


ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor( 
2, 5, 30, TimeUnit.SECONDS,new LinkedBlockingQueue<Runnable> 
(128), sThreadFactory,handler); 


forl(int i=0;i<10;i++){ 
final int iValue=i; 
Runnable runnable=new Runnable(){ 
@Override 
public void run() { 
SystemClock.sleep(1000); 
Log.i("ansen", "当前 线程 id:"+android.os.Process myTid()+™ 
iValue:"+iValue); 
3 
] 7 
threadPoolLExecutor .execute (unnable) 


} 


我 们 主要 查看 new ThreadPoolExecutor 对 象 时 传 入 的 参数 :核心 线程 为 2， 最 大 线程 数 为 5， 
线程 空 闪 时 保持 时 间 30 秒 ; LinkedBlockingQueue 为 无 界 队 列 ， 其 长 度 为 128; sThreadFactory 参 
数 与 handler 参数 没有 用 默认 值 ， 都 自己 重 写 

接 下 来 是 for 循环 10 次 ， 在 循环 中 调用 execute 方法 执行 Runnable。 

sThreadFactory 参数 使 用 内 部 类 方式 实现 了 ThreadFactory 接口 : 


Private static final ThreadFactory sThreadFactory = new ThreadFactory() { 
// 可 以 在 并 发 情况 下 达到 原子 更 新 ， 避 免 使 用 synchronized， 而 且 性 能 非常 高 


Private final AtomicInteger mCount = new AtomicInteger (1); 


Public Thread newThread (Runnable r) { 
return new Thread(r,"ThreadPoolExecutor new Thread #"+mCount. 
getAndIncrement () ) 7 
上 
] 


handler 参数 是 自 定义 拒绝 策略 类 ， 这 个 类 的 实现 前 面 已 经 见 过 ， 就 不 贴 出 相关 代码 了 。 
运行 代码 ， 打 印 结果 如 下 : 


03-09 14:58:24.038 15397-15526/... I/ansen: 
03-09 14:58:24.038 15397-15527/... I/anse 
03-09 14:58:25.040 15397-15526/... I/anse 
03-09 14:58:25.040 15397-15527/... I/anse; 
03-09 14:58:26.042 15397-15526/... I/anse 
03-09 14:58:26.043 15397-15527/... I/anse; 
03-09 14:58:27.044 15397-15526/... I/anse 
03-09 14:58:27.045 15397-15527/... I/ansen: 当前 线程 id:15527 iValue:7 
03-09 14:58:28.046 15397-15526/... I/ansen: 当前 线程 id:15526 ivValue:8 
03-09 14:58:28.046 15397-15527/... I/ansen: 当前 线程 id:15527 iValue:9 


从 结果 中 可 以 看 到 一 共 就 开启 了 两 个 线程 ,线程 id 是 15526 与 15527, 新 建 ThreadPoolExecutor 
对 象 时 corePoolSize 也 是 传 入 的 2, LinkedBlockingQueue 长 度 为 128，execute 只 循环 执行 了 10 次 。 


当前 线程 id:15526 iValue:0 
当前 线程 id:15527 iValue:1 
当前 线程 id:15526 iValue:2 
当前 线程 id:15527 ivValue:3 
当前 线程 id:15526 iValue:4 
当前 线程 id:15527 ivValue:5 
当前 线程 id:15526 iValue:6 
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这 也 印证 了 我 们 之 前 的 结论 ， 如 果 execute 提交 的 任务 数量 小 于 BlockingQueue 长 度 ， 那 么 线程 池 
中 的 线程 数量 只 会 等 于 核心 线程 数 ， 其 余 加 入 BlockingQueue 队列 ， 依 次 等 待 执行 。 


修改 代码 ， 将 LinkedBlockingQueue 的 长 度 从 之 前 的 128 修改 为 6。 


ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor( 
2, 5, 30, TimeUnit.SECONDS, 
new LinkedBlockingQueue<Runnable>(6), sThreadFactory,handler); 


修改 后 ， 运 行 打印 结果 如 下 : 


03-09 15:07:28.445 15836-15890/ I/ansen: 当前 线程 id:15890 ivValue:0 
03-09 15:07:28.445 15836-15891/ I/ansen: 当前 线程 id:15891 iValue:1 
03-09 15:07:28.446 15836-15892/ I/ansen: 当前 线程 id:15892 ivValue:8 
03-09 15:07:28.446 15836-15893/ I/ansen: 当前 线程 id:15893 ivValue:9 
03-09 15:07:29.447 15836-15890/ I/ansen: 当前 线程 id:15890 ivValue:3 
03-09 15:07:29.447 15836-15891/ I/ansen: 当前 线程 id:15891 iValue:2 
03-09 15:07:29.447 15836-15892/ I/ansen: 当前 线程 id:15892 iValue:4 
03-09 15:07:29.449 15836-15893/ I/ansen: 当前 线程 id:15893 iValue:5 
03-09 15:07:30.449 15836-15891/ I/ansen: 当前 线程 id:15891 iValue:7 
03-09 15:07:30.449 15836-15890/ I/ansen: 当前 线程 id:15890 iValue:6 


当 我 们 调用 execute 方法 调用 前 两 次 时 ， 会 开启 两 个 核心 线程 进行 处 理 ， 循 环 到 第 6 次 时 还 能 





加 入 LinkedBlockingQueue 队列 ， 循 环 到 第 7 次 时 发 现 队 列 满 了 ， 这 时 就 会 开启 非 核心 线程 去 处 理 
任务 。 


是 6， 


我 们 继续 修改 ThreadPoolExecutor 参数 ， 将 maximumPoolSize 最 大 线程 数 改 为 3。 


ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor( 
2, 3, 30, TimeUnit.SECONDS, 
new LinkedBlockingQueue<Runnable>(6), sThreadFactory,handler); 


运行 结果 如 下 : 


03-09 15:42:18.944 19397-19397/... E/AndroidRuntime: FATAL EXCEPTION: main 

POCOBs BID T9397. 

java.util.concurrent .RejectedExecutionException: 任务 被 拒绝 

at com.ansen.threadpoolexecutor.MainActivity$MyRejectedExecutionHandler. 
rejectedExecution(MainActivity.java:78) 

RA 

at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run (RuntimeInit. 
java:438) 

at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:807) 

03-09 15:42:19.943 19397-19589/... I/ansen: 当前 线程 id:19589 ivValue:1 

03-09 15:42:19.943 19397-19588/... I/ansen: 当前 线程 id:19588 ivalue:0 

03-09 15:42:19.944 19397-19590/... I/ansen: 当前 线程 id:19590 ivValue:8 

03-09 15:42:20.943 19397-19589/... I/ansen: 当前 线程 id:19589 ivalue:2 

03=09 15242»:20.944 19397=19588/..5 当前 线程 id:19588 iValue:3 

03=09 15:42»20.944 19397=19590W. .5 当前 线程 id:19590 ivValue:4 

03=09" 15542»:21.944 19397=19589/s .0 当前 线程 id:19589 iValue:5 

03=09 15:42:21.945 19397=19588/5.。 当前 线程 id:19588 iValue:6 

03-09 15:42:21.946 19397-19590/... I/ansen: 当前 线程 id:19590 ivalue:7 


从 ThreadPoolExecutor 构造 方法 中 可 以 看 到 最 大 线程 数 是 3, LinkedBlockingQueue 队列 的 长 度 
9 个 任务 是 处 理 的 极限 了 。 当 execute 方法 启动 第 10 个 任务 时 会 抛 出 异常 ， 拒 绝 添加 任务 。 
自己 配置 ThreadPoolExecutor 类 , 面 对 这 么 多 的 参数 ， 当 用 到 线程 池 时 也 不 知道 核心 线程 数 给 
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多 少 合适 ， 用 LinkedBlockingQueue 队列 好 还 是 ArrayBlockingQueue 好 。 还 记得 我 们 前 面 学 过 
AsyncTask 创建 后 台 线程 吧 , 其 实 它 内 部 就 用 到 了 线程 池 , 我 们 跟踪 到 源码 里 面 看 看 是 如 何 实现 的 。 
Private static final int CPU COUNT = Runtime .getRuntime () .availableProcessors () 
private static final int CORE POOL SIZE = Math.max(2, Math.min(CPU COUNT - 1, 4)); 
Private static final int MAXIMUM POOL SIZE = CPU COUNT * 2+1; 
Private static final int KEEP ALIVE SECONDS = 30; 
private static final ThreadFactory sThreadFactory = new ThreadFactory() { 
Private final AtomicInteger mCount = new AtomicInteger (1); 


Public Thread newThread (Runnable r) { 
return new Threadl(r, "AsyncTask #" + mCount .getandIncrement ()); 
} 
] 7 
Private static final BlockingQueue<Runnable> sPoolWorkQueue = 
new LinkedBlockingQueue<Runnable>(128); 


ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor!( 

CORE POOL SIZE, MAXIMUM POOL SIZE, KEEP ALIVE SECONDS, TimeUnit.SECONDS, 
sPoolWorkQueue, sThreadFactory); 
threadPoolExecutor.allowCoreThreadTimeOut (true); 


核心 线程 数 跟 CPU 核 数 有 关 ， 结 果 在 2~4。 最 大 线程 数 就 是 CPU 核 数 *2+1， 线程 空闲 时 保持 
30 秒 ,用 的 是 LinkedBlockingQueue 队列 ,设置 长 度 是 128, 并 且 调 用 了 allowCoreThreadTimeOut(true) 
方法 ， 也 就 是 说 核心 线程 闲置 时 间 超 过 keepAliveTime 之 后 照样 回收 。 

除了 我 们 根据 AsyncTask 类 来 配置 参数 之 外 ， 其 实 系统 已 经 给 我 们 封装 了 几 个 常用 的 线程 池 。 

1. Executors.newCachedThreadPool() 队列 大 小 不 固定 线程 池 线程 超时 自动 回收 ) 

源码 如 下 : 

Public static ExecutorService newCachedThreadPool() { 

return new ThreadPoolExecutor(0, Integer.MAX VALUE, 
60L, TimeUnit.SECONDS, 
new SynchronousQueue<Runnable>()); 

} 

从 源码 中 可 以 看 到 没有 核心 线程 ， 最 大 线程 数 是 int 类 型 的 最 大 值 ， 几 乎 是 无 穷 大 ， 线 程 空闲 
超时 时 间 是 30 秒 ， 并 且 用 SynchronousQueue 作为 队列 。 

这 个 队列 有 什么 优点 呢 ? 当 我 们 调用 execute 方法 执行 一 个 新 任务 时 ,线程 池 就 会 开启 一 个 新 
线程 去 处 理 。 有 多 少 个 任务 就 会 启动 多 少 个 线程 。 最 大 线程 数 是 无 穷 大 ， 所 以 可 以 提交 大 量 任 务 ， 
需要 注意 的 是 没有 核心 线程 , 并 且 设置 了 线程 空闲 时 间 为 30 秒 , 所 以 线程 池 会 自动 回收 空闲 线程 。 
当 所 有 任务 执行 完毕 并 且 没 有 提交 新 任务 时 ， 线 程 池 中 一 个 线程 也 没有 。 

2. Executors.newFixedThreadPool(int) 创 建 固定 线程 数 的 线程 池 

源码 如 下 : 

Ppublic static ExecutorService newFixedThreadPool (int nThreads) { 

return new ThreadPoolExecutor (nThreads, nThreads, 


0L, TimeUnit .MILLISECONDS, 
new LinkedBlockingQueue<Runnable> ()); 
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从 源码 中 我 们 可 以 看 到 核心 线程 数 跟 最 大 线程 数 是 一 样 的 值 ， 就 是 我 们 传 入 的 线程 数 。 线 程 
室 闲 时 保持 时 间 是 0 毫秒 ， 并 且 LinkedBlockingQueue 队列 没 指定 长 度 。 

这 个 线程 池 有 什么 特点 呢 ? 如 果 线 程 池 中 所 有 的 线程 处 于 忙碌 状态 ， 新 添加 的 任务 就 会 保存 
在 队列 中 ,队列 没有 指定 长 度 基本 可 以 无 限 添加 。 线 程 空闲 时 也 不 会 超时 销毁 ， 所 有 线程 池 中 线程 
数量 永远 国定 并 且 一 直 存 在 。 除 非 调用 shutdown() 方 法 才 会 销毁 线程 。 这 个 线程 池 不 会 频繁 地 创建 
和 销毁 线程 ， 线 程 数 永远 保持 在 一 个 固定 的 数量 。 

3. Executors.newSingleThreadExecutor() 单 线程 线程 池 

源码 如 下 : 

public static ExecutorService newSingleThreadExecutor() { 

return new FinalizableDelegatedExecutorService 
(new ThreadPoolExecutor (1，1， 


0L, TimeUnit.MILLISECONDS, 
new LinkedBlockingQueue<Runnable>())); 








源码 跟 newFixedThreadPool 线程 池 有 点 相似 ， 唯 一 的 区 别 就 是 核心 线程 数 跟 最 大 线程 数 都 是 
1， 也 就 是 说 这 个 线程 池 永远 只 有 一 个 线程 ， 保 证 所 有 任务 按照 指定 顺序 执行 。 
4. ScheduledThreadPoolExecutor() 定 时 定期 执行 任务 功能 的 线程 池 


ScheduledThreadPoolExecutor 是 一 个 具有 定时 定期 执行 任务 功能 的 线程 池 ， 是 
ThreadPoolExecutor 的 子 类 ， 跟 前 面 介绍 的 其 他 线程 池 一 样 ， 也 是 基于 ThreadPoolExecutor 类 实现 
的 线程 池 。 源 码 如 下 : 

Private static final long DEFAULT KEEPALIVE MILLIS = 10L; 

public ScheduledThreadPoolExecutor (int corePoolSize) { 

super (corePoolSize, Integer.MAX VALUE, 
DEFAULT KEEPALIVE MILLIS, MILLISECONDS, 


new DelayedWorkQueue()); 
| 


构建 ScheduledThreadPool 线程 池 必 须要 指定 核心 线程 数 ， 最 大 线程 数 是 无 穷 大 ， 非 核心 线程 
室 闲 时 间 是 10 毫秒 , 队列 用 的 是 DelayedWorkQueue。DelayedWorkQueue 是 无 界 的 BlockingQueue， 
用 于 放置 实现 了 Delayed 接口 的 对 象 ， 其 中 的 对 象 只 能 在 其 到 期 时 才能 从 队列 中 取 走 。 这 种 队列 是 
有 序 的 ， 即 队 头 对 象 的 延迟 到 期 时 间 最 长 。 
写 个 简单 的 demo 来 实现 一 下 : 
ScheduledThreadPoolExecutor executorService=new ScheduledThreadPoolExecutor (1); 
Runnable runnable=new Runnable() { 
@Override 
public void run() { 
Log.i("ansen",， "ScheduledThreadPoolExecutor 任务 执行 完成 ") ; 
} 
] 7 
Log.i("ansen", "ScheduledThreadPoolExecutor 任务 开始 完成 ") ; 
executorService.schedule (runnable,5,TimeUnit.SECONDS); 


创建 ScheduledThreadPoolExecutor 对 象 时 指定 核心 线程 数 ， 这 里 我 们 传 入 1。 需要 注意 的 是 我 
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们 调用 schedule 方法 执行 任务 ， 有 三 个 参数 ， 整 体 意思 就 是 5 秒 后 执行 任务 。 


ecommand Runnable 对 象 ， 要 执行 的 任务 。 

@ delay， 任 务 延 迟 多 久 执行 。 

e unit， 第 二 个 参数 的 单位 。 

运行 代码 ， 打 印 log 如 下 : 

03-10 17:25:40.125 ... I/ansen: ScheduledThreadPoolExecutor 任务 开始 完成 

03-10 17:25:45.128 ... I/ansen: ScheduledThreadPoolExecutor 任务 执行 完成 

从 两 条 log 中 可 以 看 到 时 间 差 不 多 相差 5 秒 。 

5. 线程 池 其 他 常用 方法 

eshutDown: 已 经 执行 的 任务 继续 执行 ， 队 列 中 的 任务 停止 执行 ， 并 且 不 再 接收 新 任务 。 

@ shutdownNow: 尝试 停止 所 有 正在 执行 的 任务 ， 暂 停 队 列 中 的 任务 ， 返 回 正在 执行 的 任务 列 
表 。 
execute: 执行 任务 。 
submit: 执行 任务 并 且 返 回 Future 接口 ， 通 过 这 个 Future 的 get 方法 取得 返回 值 。 通 过 它 的 
isDone 方法 可 以 判断 是 否 执行 成 功 ! 
setKeepAliveTime: 线程 空闲 时 销毁 时 间 。 
allowCoreThreadTimeOut(boolean value): 设置 为 tue， 线 程 空 闲 销毁 时 间 针 对 核心 线程 ; 设 
置 为 false， 线 程 空闲 销毁 时 间 针对 非 核心 线程 。 


Android 网 络 编程 与 数据 存储 


随 着 互联 网 飞速 的 发 展 ， 很 多 行业 都 离 不 开 网 络 ， 应 用 市 场 上 大 部 分 App 也 都 需要 服务 器 支 
持 。 本 章 就 学 习 在 Android 中 如 何 发 送 网 络 请 求 ， 以 及 网 络 请 求 开源 库 OKHttp 的 使 用 、 对 OKHttp 
进行 简单 封装 。 同 时 ， 学 习 数 据 存储 的 三 种 方式 以 及 不 同 之 处 ， 以 便 我 们 在 不 同 的 业务 场景 下 选择 
不 同 的 存储 方式 。 


6.1 基于 Android 平台 的 HTTP 通信 


HTTP (Hypertext Transfer Protocol， 超 文本 传输 协议 ) 是 互联 网 上 应 用 最 为 广泛 的 一 种 网 络 协 
议 ， 也 是 手机 联网 常用 的 协议 之 一 ， 所 有 的 WWW 文件 必须 遵守 这 个 标准 。HTTP 协议 是 建立 在 
TCP 协议 之 上 的 一 种 协议 。 简单 来 说 , HTTP 协议 就 是 客户 端 和 服务 器 端 之 间 数 据 传 输 的 格式 规范 。 
HTTP 协议 具有 以 下 特点 : 
支持 B/S 以 及 C/S 模式 。 
简单 快速 : 客户 向 服务 器 请 求 服务 时 ， 只 需 传送 请 求 方法 和 路 径 。 常 用 的 请 求 方法 有 Get、 
Head 和 Post。 
灵活 : HTTP 允许 传输 任意 类 型 的 数据 对 象 ， 正 在 传输 的 类 型 由 Content-Type 加 以 标记 。 
无 状态 : HTTP 协议 是 无 状态 协议 。 无 状态 是 指 协议 对 于 事务 处 理 没有 记忆 能 力 。 如 果 后 续 
处 理 需要 前 面 的 信息 ， 就 必须 重 传 ， 这 样 可 能 会 导致 每 次 连接 传送 的 数据 量 增 大 。 
HTTP 协议 包括 两 个 具体 的 请 求 方式 Get 以 及 Post， 主 要 有 以 下 区 别 : 
@ Get 通常 是 从 服务 器 上 获取 数据 。Post 通常 是 向 服务 器 传送 数据 。 
日 ”Get 将 参数 拼接 在 URL 后 面 。Post 是 将 参数 作为 HTTP 请 求 的 内 容 发 送 到 指定 的 URL 中 。 
@ ”Get 传送 数据 量 比较 小 ， 最 多 只 能 是 2048 字 节 (不同 的 浏览 器 略 有 区 别 )。Post 传送 的 数据 


第 6 章 Android 网 络 编程 与 数据 存储 | 217 





量 比较 大 ， 一 般 被 默认 为 不 受 限 制 。 
@ ”Get 安全 性 非常 低 。Post 安全 性 较 高 。 


一 般 企业 开发 中 ， 从 服务 器 获取 数据 时 使 用 Get 请 求 ， 而 增加 、 删 除 、 修 改 时 使 用 Post 请 求 。 


6.1.1 使 用 Get 方式 向 服务 器 提交 数据 


使 用 Get 请 求 方式 访问 服务 器 的 登录 接口 。 在 Android 中 ， 提 供 了 标准 Java 接口 
HttpURLConnection， 通 过 url.openConnection() 方 法 就 能 够 获取 。 
因为 要 访问 网 络 ， 所 以 要 在 AndroidManifest.xml 文件 中 增加 访问 网 络 的 权限 : 


<uses-permission android:name="android.permission.INTERNET"/> 


新 建 一 个 项 目 , 在 MainActivity 中 增加 一 个 方法 getUserInfo(String userid)。 首先 新 建 一 个 URL 
对 象 ,在 构造 方法 中 传 入 一 个 请 求 路 径 , 请 求 路 径 根据 userid 拼接 。 接 下 来 ,调用 urlLopenConnection(0) 
方法 ， 打 开 一 个 链接 ， 强 转 成 HttpURLConnection 对 象 。 这 个 对 象 有 很 多 方法 ， 例 如 
setConnectTimeout 设置 连接 超时 时 间 ，setRequestMethod 设置 请 求 方式 ， 这 里 设置 的 是 Get 请 求 。 
最 后 判断 返回 的 状态 码 是 不 是 200。200 代表 请 求 成 功 ， 从 连接 中 获取 输入 流 ， 通 过 
dealResponseResult 方法 读 取出 来 并 且 转 换 成 字符 串 。 


Private String getUserInfo (String userid){ 
//get 方式 提交 就 是 url 拼接 的 方式 
String path="http://139.196.35.30:8080/0kHttpTest/getUserInfo.do?userid= 
"+userid; 
1 
URL url = new URL(path); 
HttPURLConnection connection = (HttpURLConnection) 
url.openConnection(); 
connection.setConnectTimeout (5000) ;// 设 置 连接 超时 时 间 
connection.setRequestMethod ("GET") ;// 设 置 以 Get 方式 提交 数据 
if (connection.getResponseCode () ==200) {// 请 求 成 功 
InputStream is = connection.getInputStream(); 
return dealResponseResult (is); 
} 
}catch (Exception e) { 
e.printStackTrace (); 
上 
return null; 


} 


上 面 用 到 的 dealResponseResult 方法 代码 如 下 。 从 输入 流 中 循环 读 取 byte 数组 ， 存 入 输出 流 ， 
最 后 将 输出 流转 换 成 字符 串 返 回 。 
/** 
* 处 理 服务 器 的 响应 结果 (将 输入 流转 化 成 字符 串 ) 
* @param inputStream 服务 器 的 响应 输入 流 
* @return 
的 
Private String dealResponseResult (InputStream inputStream) { 
String resultData = null; // 存 储 处 理 结果 
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ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream(); 
byte[] data = new byte[1024]; 
int len = 0; 
tev 
while((len = inputStream.read(data)) != -1) { 
byteArrayOutputStream.write(data, 0, len); 
上 
} catch (IOException e) { 
e.pPrintStackTrace () 7 
} 
resultData = new String(byteArrayOutputStream.toByteArray ()); 
return resultData; 


6.1.2 ”使 用 Post 方式 向 服务 器 提交 数据 


在 MainActivity 中 继续 增加 login (String usermmame,String password ) 方法 , 这 是 一 个 Post 请 求 。 
Post 请 求 与 Get 请 求 的 代码 差不多 ， 只 是 传递 参数 的 方式 不 一 样 。setRequestMethod 方法 传 入 的 是 
Post， 并 且 需 要 通过 setRequestProperty 方法 设置 请 求 属性 ， 然 后 从 connection 中 获取 输出 流 ， 通 过 
write 方法 将 参数 写 进去 ， 后 面 请 求 成 功 并 且 解 析 成 字符 串 与 Get 请 求 一 致 。 
Private String login(String username,String password){ 
String path = "http://139.196.35.30:8080/0kHttpTest/login.do"; 
ey 
URL url = new URL (Path) 7 
HttpURLConnection connection = (HttpURLConnection) 
url.openConnection(); 
connection.setConnectTimeout (5000) ;// 设 置 连接 超时 时 间 


connection.setRequestMethod ("POST") ;// 设 置 以 Post 方式 提交 数据 
String data = "username="+tusername+"&password="+password; // 请 求 数据 





/ /至少 要 设置 的 两 个 请 求 头 

connection.setRequestProperty ("Content-Type","application/ 
x-www-form- urlencoded"); 

connection.setRequestProperty ("Content-Length",data.length()+""); 


//post 方式 提交 的 实际 上 是 以 流 的 方式 提交 给 服务 器 
connection.setDoOutput (true); 

OutputStream outputStream = connection.getOutputStream(); 
outputStream.write (data.getBytes ()); 


if (connection.getResponseCode () ==200) {// 状 态 码 ==200 请 求 成 功 
InputStream is = connection.getIinputStream(); 
return dealResponseResult (is); 
} 
}catch (Exception e) { 
e.printSstackTrace (); 
} 
return null; 
1 


两 种 访问 方式 封装 了 两 个 方法 。 接 下 来 在 MainActivity 中 通过 点 击 按钮 来 调用 这 两 个 方法 。 在 
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Android 中 不 能 在 主线 程 中 访问 网 络 (防止 UI 堵塞) ,所 以 需要 开启 一 个 线程 来 访问 网 络 。 


Q@Override 

Public void onClick(View view) 
// 在 Android 中 不 能 在 主线 和 中 沪 问 I 网 络 ， 所 以 需要 开启 一 个 线程 
new TestGetOrPostThread (view) .start (); 

和 


Public class TestGetOrPostThread extends Thread{ 
private View view; 
Public TestGetOrPostThread (View view){ 
this.view=view; 


1 


@Override 
public void run() { 
Switch (view.getId()){ 
case R.id.btn get://get 请 求 
String getResult=getUserInfo("123"); 
Log.i("MainActivity", "Get 获取 用 户 信息 :"+getResult) ; 
break; 
case R.id.btn post://post 请 求 
String postResult=login("ansen", "123"); 
Log.i("MainActivity", "Post 登录 结果 :"+postResult); 
break; 


} 
点 击 “Get 请 求 ” 按 钮 打印 日 志 如 下 ， 结 果 JSON 只 是 截取 了 一 部 分 : 


I/MainActivity: Get 获取 用 户 信 息 :{"errorReason":"","password":"123", 
"username": "ansen"} 


点 击 “Post 请 求 ”按钮 ， 打 印 日 志 如 下 : 


I/MainActivity: Post 登录 结果 :{"errorReason":" 登 录 成 功 ", "password":"123", 
"username": "ansen"} 


这 两 个 请 求 的 接口 是 用 Java Web 编写 的 服务 器 ， 部 署 在 云 服 务 嚣 上， 所 以 大 家 测试 时 ， 只 要 
网 络 环境 是 正常 的 ， 就 能 够 访问 这 两 个 接口 并 且 返 回 JSON 数据 。 


6.1.3 ”使 用 GSON 解析 JSON 格式 的 数据 


普通 的 JSON 解法 是 通过 JsonObject 和 JsonArray 这 两 个 对 象 配合 完成 的 ， 有 一 个 缺点 ， 即 当 
服务 器 返回 的 数据 比较 复杂 时 解析 起 来 很 麻烦 , 如果 层 次 很 多 就 需要 一 层 层 遍 历 。 接 下 来 讲解 如 何 
用 GSON 包 解析 JSON 数据 。 

1. JSON 介绍 

JSON (JavaScript Object Notation, JS 对 象 标记 ) 是 一 种 轻 量 级 的 数据 交换 格式 。 它 是 基于 
ECMAScript 规范 的 一 个 子 集 ， 采 用 完全 独立 于 编程 语言 的 文本 格式 来 存储 和 表示 数据 。 简 洁 和 清 
晰 的 层次 结构 使 得 JSON 成 为 理想 的 数据 交换 语言 , 易于 阅读 和 编写 , 同时 也 易于 机 器 解析 和 生成 ， 
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并 有 效 地 提升 网 络 传输 效率 。 现 在 大 部 分 App 都 使 用 JSON 给 前 端 返 回 数据 。 


2 


.GSON 包 


GSON 是 Google 提供 的 用 来 在 Java 对 象 和 JSON 数据 之 间 进 行 映射 的 Java 类 库 , 可 以 将 一 个 
JSON 字符 串 转换 成 一 个 Java 对 象 ， 或 者 反 过 来 转换 。GSON 包 和 解析 JSON 数据 主要 有 以 下 几 个 优点 

@ 快速 、 高 效 。 

e 代码 量 少 、 简 洁 。 

@ ”面向 对 象 ( 直接 把 JSON 转换 成 对 象 )。 

3. 几 种 常见 的 JSON 数据 如 何 解析 成 Java 对 象 


使 用 Android Studio 开发 时 ， 可 以 通过 在 线 引 用 库 的 方式 。 在 project/app/build.gradle 文件 中 的 
dependencies 下 加 入 一 名 代码 : 





compile 'com.google.code.gson:gson:2.8.0' 

Gradle 会 默认 从 Jcenter Maven 仓库 获取 aar 文件 。 

(1) 解析 对 象 

现在 有 一 个 JSON 字符 串 "{'name':'Ansen', 'age':20}"， 包 含 name 与 age 两 个 属性 ， 可 以 写 一 
个 实体 类 User 进行 对 应 ， 并重 写 toString 方法 。 输出 对 象 时 会 输出 所 有 属性 ,而 不 是 一 个 hash 值 。 


public class User { 


1 


private String name;// 姓 名 
private int age;// 年 龄 


public String getName() { 
return name; 


Public void setName (String name) { 
this.name = name; 


public int getAge() { 
return age; 


上 


public void setAgel(int age) { 
this.age = age; 
} 


QOverride 
public String toString() { 
return "User{t” + 
"name="'" + name + '\'' + 
", age=" + age + 
ry 


使 用 GSON 包 将 JSON 字符 串 转 换 成 User 对 象 。 这 里 使 用 的 GSON 对 象 是 MainActivity 的 实 
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例 变量 。 调 用 fromJson 方法 就 能 转换 。 


String jsonStr="{"'name':'Ansen', "age':20}"7 
User user=gson.fromJson(jsonSstr, User.class); 
Log.i("MainActivity","parseObject user:"+user.toString()); 


(2) 解析 成 数组 
上 面 将 JSON 字符 串 转换 成 了 对 象 , 在 实际 开发 中 , 服务 器 给 用 户 一 个 数组 格式 的 JSON 数据 
也 很 常见 ， 与 转换 对 象 基本 是 一 样 的 。 


String jsonStr=" [{'name':'Uini'，"age':30},{f'name':'Lina'，'"age':10}]"7 
List<User> Users=gson.fromJson (jsonStr,new TypeToken<List<User>>() 
{}.getType ()); 
forl(int i=0;i<users.size();i++){ 
Log.i("MainActivity","parseArrayList user:"+t+users.get (i)); 


} 
(3 ) 解析 成 Map 


String jsonstr="{'1': {'name':'haha', 'age':11},'2': {'name':'nihao', 'age':22}}"; 
Map<String, User> users = gson.fromJson(jsonstr, new 
TypeToken<Map<String,User>>() {}.getType()); 
for (String key:users.keySet()){ 
Log.i("MainActivity","parseMap key:"+key+" User:"+users.get (key)); 
由 


(4) 对 象 解析 成 JSON 字符 串 

我 们 已 经 知道 了 将 JSON 字符 串 转换 成 对 象 的 方法 , 那么 如 何 将 对 象 转换 成 JSON 字符 串 呢 ? 
其 实 也 很 简单 ，GSON 包 都 封装 好 了 。 新 建 一 个 User 对 象 ， 然 后 调用 GSON 类 的 toJson 方法 就 能 
将 User 对 象 转换 成 JSON 字符 串 。 


User user=new User(); 

user.setAge(111); 

user.setName ("nime"); 

String jsonStr=gson.toJson (user); 
Log.i("MainActivity","jsonSstr:"+jsonStr); 


运行 以 上 代码 ， 打 印 的 日 志 如 下 : 


05-15 09:56:20.430 5630-5630/? I/MainActivity: parseObject 
user:User{name='Ansen', age=20} 

05-15 09:56:20.440 5630-5630/? I/MainActivity: parseArrayList 
user:User{name='Uini', age=30} 

05-15 09:56:20.440 5630-5630/? I/MainActivity: parseArrayList 
user:User{name='Lina', age=10} 

05-15 09:56:20.440 5630-5630/? I/MainActivity: parseMap key:1 
user:User{name='haha', age=11} 

05-15 09:56:20.440 5630-5630/? I/MainActivity: parseMap key:2 
user:User{name='nihao', age=22} 

05-15 09:56:20.440 5630-5630/? I/MainActivity: jsonStr:{"name":"nime","age":111} 


6.1.4 ”OkHttp 开源 项 目的 使 用 


Android 系统 提供 了 两 种 HTTP 通信 类 : HttpURLConnection 和 HttpClient。 HttpURLConnection 
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相对 来 说 比 HttpClient 难 用 ，Google 自从 2.3 版 本 之 后 一 直 推 荐 使 用 HttpURLConnection， 并 且 在 
6.0 版 本 的 SDK 中 直接 删除 了 HttpClient 类 。 

不 过 ， 上 面 两 个 类 库 和 OkHttp 相 比 起 来 就 弱 爆 了 ， 因 为 OkHttp 不 仅 具有 高 效 的 请 求 效 率 ， 
并 且 节 省 宽带 ， 还 提供 了 很 多 开 箱 即 用 的 网 络 疑难 杂 症 解决 方案 。 

@ 支持 HTTP/2。HTTP/2 通过 使 用 多 路 复 用 技术 在 一 个 单独 的 TCP 连接 上 支持 并 发 , 通过 在 一 
个 连接 上 一 次 性 发 送 多 个 请 求 来 发 送 或 接收 数据 。 
如 果 HTTP/2 不 可 用 ， 连 接 池 减 少 请 求 延迟 。 
支持 GZIP， 可 以 压缩 下 载体 积 。 
响应 缓存 可 以 避免 重复 请 求 网 络 。 
从 很 多 常用 的 连接 问题 中 自动 恢复 ， 如 果 服 务 器 配置 了 多 个 PP 地 址 ， 当 第 一 个 IP 连接 失败 
时 ，OkHttp 会 自动 尝试 下 一 个 卫 。 

ee OkHttp 还 处 理 了 代理 服务 器 问题 和 SSL 握手 失败 问题 。 

1. OkHttp 的 基本 使 用 

这 里 将 讲解 OkHttp 的 基本 使 用 方法 ， 大 家 有 其 他 需求 时 可 以 自行 扩展 。 以 下 的 所 有 请 求 都 是 
异步 请 求 服务 器 ， 在 实际 开发 中 ， 基 本 都 是 异步 。 

(1) 依赖 

Android Studio 可 以 在 线 依 赖 ， 在 app/build.gradle 文件 中 加 上 下 面 这 句 代 码 即 可 。 

compile "com.squareup .okhttp3:okhttp:3.8.0" 

(2 ) Get 请 求 

首先 创建 一 个 全 局 的 OkHttpClient 对 象 ， 所 有 的 Http 请 求 都 共用 这 个 对 象 即 可 。 

private OkHttpClient client = new OkHttpClient (); 

- 般 从 服务 器 获取 信息 的 接口 都 是 Get 请 求 ， 这 里 调用 获取 用 户 的 信息 接口 。 


Private void getUserInfo(){ 
// 创 建 一 个 请 求 
Request .Builder builder = new Request.Builder() .url 
("http://139.196.35.30:8080/0kHttpTest/getUserInfo.do"); 
execute (builder); 


} 
// 执 行 请 求 


Private void execute (Request.Builder builder){ 
Call call = client.newCall (builder.build()); 
call.enqueue (callback) ;// 加 入 调度 队列 

. 


// 请 求 回 调 
Private Callback callback=new Callback(){ 
@Override 
Public void onFailure(Call call, IOException e) { 
Log.i("MainActivity","onFailure"); 
e.printStackTrace (); 
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@Override 

public void onResponse(Call call, Response response) throws IOException{ 
// 从 response 获取 服务 器 返回 的 数据 ， 转 换 成 字符 串 处 理 
String str = new String(response.body() .bytes () ，"utf-8") 
Log.i("MainActivity","onResponse:"+str); 


// 通 过 Handler 更 新 UI 

Message message=handler.obtainMessage(); 
message.obj=str; 

message.sendToTarget (); 


] 7 
创建 一 个 request 对 象 ， 通 过 request 设置 请 求 url， 通 过 这 个 类 还 可 以 设置 更 多 的 请 求 信息 。 
通过 Request 去 构造 一 个 Call 对 象 。 
调用 enqueue 执行 异步 请 求 ， 有 一 个 参数 设置 回调 。 请求 成 功 或 者 失败 会 调用 Callback 接口 
的 onResponse 与 onFailure 方法 ， 因 为 这 是 异步 请 求 ， 在 回调 方法 中 不 能 直接 更 新 UI， 所 以 
需要 通过 Handler 去 更 新 UL。 


Handler 的 代码 很 简单 ， 就 是 将 请 求 的 结果 显示 在 TextView 上 : 


Private Handler handler=new Handler(){ 
@Override 
Public void handleMessage (Message msg) { 
String result= (String) msg.obj; 
tvResult.setText (result); 


] 7 
( 3 ) Post 请 求 
通过 调用 登录 接口 发 送 一 个 Post 请 求 。 与 Get 不 一 样 的 地 方 就 是 传递 参数 不 一 样 ，Post 请 求 
需要 将 参数 封装 到 RequestBody 对 象 ， 调 用 Request 对 象 的 Post 方法 将 RequestBody 传 入 进去 。 最 
后 调用 execute 方法 执行 请 求 ， 这 个 方法 在 前 面 讲解 Get 请 求 时 介绍 过 。 
Private void login(){ 
// 将 请 求 参 数 封 装 到 RequestBody 中 
FormBody.Builder formBuilder = new FormBody.Builder(); 
formBuilder.add("username", "ansen") ; // 请 求 参数 一 


formBuilder.add ("password", "123") ;// 请 求 参数 二 
RequestBody requestBody = formBuilder.build(); 


Request .Builder builder = new Request.Builder() .url("http: 
//139.196.35.30:8080/ OkHttpTest/login.do") .post (requestBody); 
execute (builder); 
} 


(4) 文件 上 传 

上 传 文件 需要 用 到 MultipartBody 对 象 ， 通 过 调用 addFormDataPart 方法 添加 表单 参数 ， 通 过 
setType 方法 设置 内 容 类 型 ， 这 里 设置 form 表单 类 型 ， 调 用 自己 的 getUploadFileBytes 方法 获取 文 
件 byte 数组 。 通 过 addFormDataPart 方法 添加 文件 ， 后 面 的 流程 与 之 前 的 Post 请 求 一 样 。 
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Private void uploadFile(){ 
MultipartBody.Builder builder = new MultipartBody.Builder(); 
builder.addFormDataPart ("username"，"ansen") ;// 表 单 参数 
builder.addFormDataPart ("password"，"123456") ;// 表 单 参数 


builder.setType (MultipartBody .FORM); 
MediaType mediaType = MediaType.parse ("application/octet-stream"); 


byte[] bytes=getUploadFileBytes() ;// 获 取 文件 内 容 存 入 byte 数组 
// 上 传 文件 参数 1:name 参数 2: 文 件 名 称 参数 3: 文 件 byte 数组 
builder.addFormDataPart ("upload file", "ansen.txt",RequestBody.create 
(mediaType,bytes)); 
RequestBody requestBody = builder.build(); 
Request .Builder requestBuider = new Request.Builder(); 
requestBuider.url ("http://139.196.35.30:8080/0kHttpTest/uploadFile.do"); 
requestBuider.post (requestBody); 
execute (requestBuider); 
jl 
如 何 证 明文 件 上 传 到 服务 器 呢 ? 只 需 打 开 浏 览 器 ， 输 入 下 面 这 个 地 址 ， 就 能 看 到 文件 内 容 了 。 
如 果 是 本 地 服务 器 记得 把 139.196.35.30 改 成 localhost。 


http://139.196.35.30:8080/0kHttpTest/upload/ansen.txt 


通过 HTTP 协议 请 求 服务 器 数据 ， 常 用 的 就 这 几 种 请 求 ,， 如果 有 特殊 需求 ， 可 以 自己 扩展 〈 如 
下 载 文件 、 从 服务 器 下 载 图 片 等 ) 。 


(5) 服务 器 接口 

这 三 个 接口 的 服务 器 代码 是 作者 自己 用 Java Web 编写 的 ， 开 发 工具 用 的 是 IntelliJ IDEA， 服 
务 器 是 Tomcat， 已 经 部 署 在 云 上 ，139.196.35.30 是 云 服 务 器 的 外 网 IP， 方便 大 家 测试 。 服 务 器 代 
码 已 经 放 在 GitHub 上 ， 扩 展 接口 或 者 查看 源码 都 很 方便 。 

2. OKHttp 封装 

前 面 介绍 了 OKHttp 的 基本 使 用 方法 ， 并 在 Activity 中 写 了 大 量 访问 网 络 的 代码 。 这 种 代码 写 
起 来 很 无 聊 , 并 且 对 技术 没有 什么 提升 。 在 实际 开发 中 , 可 以 将 这 些 代 码 封 装 起 来 , 制作 成 一 个 库 ， 
便于 Activity 调用 。 

封装 之 前 ， 需 要 考虑 以 下 问题 : 
封装 基本 的 公共 方法 给 外 部 调用 ， 例 如 Get 请求、Post 请求、PostFile 等 。 
官方 建议 OkHttpClient 实例 仅 新 建 一 次 ， 所 以 网 络 请 求 库 可 以 做 成 单 例 模 式 。 
如 果 同 一 时 间 访 问 同一 个 API 多 次 ， 我 们 是 不 是 应 该 取消 之 前 的 请 求 ? 
如 果 用 户 连接 HTTP 代理 了 ， 就 不 让 访问 ， 防 止 用 户 通过 抓 包 工具 查看 我 们 的 接口 数据 。 
每 个 接口 都 要 带 上 的 参数 如 何 封装 ? 例如 App 版 本 号 、 设 备 号 和 登录 之 后 的 用 户 token， 这 
些 参 数 可 能 每 次 请 求 都 要 带 上 。 
返回 的 JSON 字符 串 转 换 成 实体 对 象 。 
@ ”访问 服务 器 是 异步 请 求 ， 如 何在 主线 程 中 调用 回调 接口 ? 
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(1) 代码 实现 


首先 需要 在 线 引用 以 下 三 个 依赖 库 : 


compile "com.squareup .okhttp3:okhttp:3.2.0' //okhttp 
compile 'com.google.code.gson:gson:2.7' // 解 析 jsons 数据 
compile 'io.github.lizhangqu:coreprogress:1.0.2' // 上 传 下 载 回调 监听 


新 建 一 个 HttpConfig 类 ， 用 来 配置 一 些 请 求 参数 〈 存 储 请 求 服务 器 的 公共 参数 、 设 置 连接 时 


间 等 ) 。 


Public class HttpConfig { 
private boolean debug=false;//true:debug 模式 


private 


String userRgent="";// 用 户 代理 ， 它 是 一 个 特殊 字符 串 头 ， 使 得 服务 器 能 够 识别 


客户 使 用 的 操作 系统 及 版 本 、cPU 类 型 、 浏 览 器 及 版 本 、 浏 览 器 泻 染 引擎 、 浏 览 器 语言 、 浏 览 器 插件 等 。 


Private boolean agent=true; 


Private 


Private 
Private 
Private 


// 有 代理 的 情况 能 不 能 访问 。true: 有 代理 能 访问 。false: 有 代理 不 能 访问 
String tagName="Http"; 


int connectTimeout=10;// 连 接 超时 时 间 ， 单 位 : 秒 
int writeTimeout=10;// 写 入 超时 时 间 ， 单 位 : 秒 
int readTimeout=30;// 读 取 超 时 时 间 ， 单 位 : 秒 


// 通 用 字段 


private 


List<NameValuePair> commonField=new ArrayList<>(); 


public boolean isDebug() { 
return debug; 


. 


Public void setDebug (boolean debug) { 
this .debug = debug; 


j 


Public String getUserAgent() { 
return userAgent; 


上 


public void setUserAgent (String userAgent) { 
this.userAgent = userAgent; 


’ 


public boolean isAgent() { 
return agent; 


} 


Public void setAgent (boolean agent) { 
this.agent = agent; 


} 


Public String getTagName () { 
return tagName; 


’ 


Public void setTagName (String tagName) { 
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我 们 给 服务 器 提交 表单 数据 都 是 通过 name 与 value 的 形式 提交 的 , 封装 了 NameValuePair 类 。 
如 果 是 上 传 文件 ， 将 isFile 设置 为 tue 即 可 。 
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return isFile; 


public void setFile (boolean file) { 
isFile = file; 
| 
外 


请 求 服务 器 成 功 或 者 失败 都 会 回调 Callback 接口 ， 我 们 封装 HttpResponseHandler 抽象 类 来 实 
现 这 个 接口 ， 对 服务 器 返回 的 数据 以 及 状态 码 进行 简单 的 过 滤 ， 最 终 调 用 自己 的 onFailure 与 
onSuccess 方法 。 


public abstract class HttpResponseHandler implements Callback { 
public HttpPResponseHandler (){ 


public void onFailure (Call call, IOException e){ 


onFailure(-l,e.getMessage() .getBytes ()); 
} 


Public void onResponse(Call call, Response response) throws IOException { 
int code =response.code(); 


byte[] body = response.body() .bytes(); 
if(code>299){ 


onFailure (response.code(),body); 
}elsef{ 


Headers headers = response.headers (); 
Header[] hs = new Header[headers.size()]; 


for (int i=0;i<headers.size();i++){ 


hs[i] = new Header (headers.name (i),headers.value (i)); 
} 


onSuccess (code, hs,body); 


i 


Public void onFailure (int status,byte[] data){ 
} 


// Public void onProgress (int bytesWritten, int totalSize) { 
AD 


Public abstract void onSuccess (int statusCode, Header[] headers，byte[] 
responseBody); 


(2 ) Get 请 求 封装 
封装 后 的 HTTPCaller 代码 如 下 : (现在 只 有 Get 请 求 的 代码 ， 如 果 将 Post 请 求 与 postFile 方 
法 贴 进来 ， 代 码 有 点 多 。) 
Public class HTTPCaller { 
Private static HTTPCaller instance = null; 


private OkHttpClient client;//okhttp 对 象 
private Map<String,Call> requestHandleMap = null;// 以 URL 为 KEY 存储 的 请 求 
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private CacheControl cacheControl = nul1;// 缓 存 控制 器 
Private Gson gson = null; 

private HttpConfig httpConfig=new HttpConfig() ;// 配 置信 息 
Private HTTPCaller() {} 


Public static HTTPCaller getInstance ()1{ 
if ( instance == null) { 
instance = new HTTPCaller(); 
上 
return instance; 


} 


/** 

* 设置 配置 信息 这 个 方法 必须 调用 一 次 

* @param httpConfig 

Sk 

public void setHttpConfig(HttpConfig httpConfig) { 
this.httpConfig = httpConfig; 


client = new OkHttpClient.Builder() 
.connectTimeout (httpConfig.getConnectTimeout ()， 
TimeUnit .SECONDS) 
.writeTimeout (httpConfig.getWriteTimeout (), TimeUnit.SECONDS) 
.readTimeout (httpConfig.getReadTimeout (), TimeUnit.SECONDS) 
.build(); 


gson = new Gson(); 
requestHandleMap = Collections.synchronizedMap (new WeakHashMap<String, 
Call>())7 
cacheControl =new CacheControl.Builder() .noStore() .noCache () .build(); 
// 不 使 用 缓存 
上 


public <T> void get (Class<T> clazz,final String url,Header[] header,final 
RequestDataCallback<T> callback) { 
this.get (clazz,url,header,callback,true); 
} 


/** 
get 请 求 
Q@param clazz json 对 应 类 的 类 型 
eparam url 请 求 url 
Q@param header 请 求 头 
eparam callback 回调 接口 
eparam autoCancel 是 否 自动 取消 。true: 同 一 时 间 请 求 一 个 接口 多 次 ， 只 保留 最 后 一 个 
* @param <T> 
wi 
Public <T> void get (final Class<T> clazz,final String url,Header[] 
header, final RequestDataCallback<T> callback, boolean autoCancel){ 
if (checkAgent()) { 
return; 


人 


和 


230 | Android App 开发 从 入 门 到 精通 





add (url,getBuilder (url, header, new 
MyHttpResponseHandler (clazz,url,callback)),autoCancel); 
j; 


Private Call getBuilder (String url, Header[] header, HttpResponseHandler 
responseCallback) { 
url=Util .getMosaicParameter (url,httpConfig.getCommonField()); 
// 拼 接 公 共 参 数 
Request.Builder builder = new Request.Builder(); 
builder.url (url); 
builder.get(); 
return execute (builder, header, responseCallback); 


1 


Private Call execute (Request.Builder builder, Header[] header, Callback 
responseCallback) { 
boolean hasUa = false; 
if (header == null) { 
builder.header ("Connection", "close" 
builder.header ("Accept", "*/*"); 
} else { 
for (Header h : header) { 
builder.header (h.getName(), h.getValue()); 
if (!hasUa && h.getName () .equals ("User-Agent")) { 
hasUa = true; 





} 
} 
if (!hasUagg!TextUtils.isEmpty (httpConfig.getUserAgent () ) ){ 
builder.header ("User-Agent",httpConfig.getUserAgent ()); 
. 
Request request = builder.cacheControl (cacheControl) .build(); 
Call call = client.newCall (request); 
call.enqueue (responseCallback); 
return call; 
) 


public class MyHttpResponseHandler<T> extends HttpResponseHandler { 
Private Class<T> clazz; 
Private String url; 
Private RequestDataCallback<T> callback; 


Public MyHttpResponseHandler (Class<T> clazz,String 
url,RequestDataCallback<T> callback){ 
this.clazz=clazz; 
this.url=url; 
this.callback=callback; 
} 


@Override 
Public void onFailure (int status, byte[] data) { 
clear (url); 
try { 
PrintLog (Url + " * + status + " "+ new String(data, "utf-8"))? 
} catch (UnsupportedEncodingException e) { 
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e.pPrintStackTrace () 7 
sendCallback (callback) 
} 


@Override 
public void onSuccess (int status,final Header[] headers, bytel[] 
responseBody) { 
try { 
clear (url); 
String str = new String(responseBody, "utf-8"); 
brintiog(laeau rm oats 0 
Tt = gson.fromJson(str, clazz); 
sendCallback (status,t,responseBody,callback); 
} catch (Exception e){ 
if (httpConfig.isDebug()) { 
e.printStackTrace (); 
printLog ("自动 解析 错误 :" + e.tostring()); 
} 
sendCallback (callback) 


Private void autoCancel (String function){ 
Call call = requestHandleMap .remove (function) 7 
if (call != null) { 
call.cancel (); 


Private void add (String url,Call call) { 
add (url,call,true); 
上 


/** 
* 保存 请 求 信 息 
* @param url 请 求 url 
* @param call http 请 求 call 
* @param autoCancel 自动 取消 
光 
Private void add (String url,Call call,boolean autoCancel) { 
if (!TextUtils.isEmpty(ur1l)){ 
if (url.contains ("?")) {//get 请 求 需要 去 除 后 面 的 参数 
url=url .substring (0,url.indexOf ("?")); 
. 
if(autoCancel){ 
autoCancel (url) ;// 如 果 同 一 时 间 对 API 进行 多 次 请 求 ， 自 动 取消 之 前 的 
1 
requestHandleMap.put (url,call); 


Private void clear (String url){ 


if (url.contains ("?")) {//get 请 求 需要 去 除 后 面 的 参数 
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url=url.substring (0,url.indexOf ("?") ) 
} 
requestHandleMap.remove (url1); 
1 


Private void PrintLog(String content){ 
if(httpConfig.isDebug()){ 
Log.i(httpConfig.getTagName (),content); 
上 
} 


/六 
* 检查 代理 
* @return 
Private boolean checkRgent () { 
if (httpConfig.isAgent()){ 
return false; 


} else { 
String proHost = android.net.Proxy.getDefaultHost (); 


int proPort = android.net.Proxy.getDefaultPort (); 
if (proHost==null || proPort<0){ 
return false; 


}else { 
Log.i (httpConfig.getTagName (), "有 代理 ,不 能 访问 "); 


return true; 


EE 


// 更 新 字段 值 
Public void updateCommonField(String key,String value){ 


httpConfig.updateCommonField (key, value); 
， 


Public void removeCommonField(String key){ 
httPConfig.removeCommonField (key) 
) 


Public void addCommonField(String key,String value){ 
httpConfig.addCommonField (key, value); 
} 


Private <T> void sendCallback (RequestDataCallback<T> callback){ 
sendCallback(-1,null,null,callback); 
} 


Private <T> void sendCallback(int status,T data,byte[] 
body, RequestDataCallback<T> callback){ 
CallbackMessage<T> msgData = new CallbackMessage<T>(); 
msgData.body = body; 
msgData.status = status; 
msgData.data = data; 
msgData.callback = callback; 
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Message msg = handler.obtainMessage(); 
msg.obj = msgData; 
handler.sendMessage (msg); 

1 


Private Handler handler=new Handler(){ 
override 
Public void handleMessage (Message msg) { 
CallbackMessage data = (CallbackMessage)msg.obj; 
data.callback (); 


}; 


Private class CallbackMessage<T>{ 
public RequestDataCallback<T> callback; 
public T data; 
public byte[] body; 
public int status; 


Public void callback(){ 
if(callback!=nul11){ 
if(data==null1){ 
callback.dataCallback (null); 
}elsel{ 
callback.dataCallback (status, data, body); 
1 


getInstance: 用 来 获取 对 象 类 的 对 象 ， 因 为 是 单 例 模式 ， 所 以 无 论 这 个 方法 调用 多 少 次 都 只 
会 创建 一 个 对 象 。 

setHttpConfig: 创建 HTTPCaller 对 象 时 必须 调用 该 方法 来 初始 化 一 些 对 象 ， 通 过 参数 
httpConfig 获取 连接 时 间 来 初始 化 OkHttpClient 对 象 ,用 WeakHashMap 来 存储 每 一 次 的 请 求 ， 
还 需要 初始 化 GSON 对 象 。 

get: 有 两 个 同名 方法 ， 即 方法 重 载 , 如果 想 同一 时 间 多 次 访问 同一 接口 ,就 采用 下 面 的 方法 ， 
最 后 逐个 参数 传 false; 如 果 没 有 要 求 ， 就 用 上 面 的 方法 。 我 们 看 到 在 get 方法 中 首先 调用 
getBuilder 发 起 了 get 请 求 ， 返 回 一 个 Call 对 象 。 这 个 方法 的 第 三 个 参数 传 入 一 个 
MyHttpResponseHandler 对 象 , 实现 了 Callback 接口 ,将 请 求 服务 器 成 功 或 者 失败 的 结果 回调 
给 这 个 类 。 最 外 层 调用 add 方法 ， 请 求 url 作为 关键 字 、Call 作为 value 保存 到 map 中 。 
getBuilder: 这 个 方法 的 第 一 行 调用 Util 的 getMosaicParameter 方法 拼接 公共 和 参数， 然后 根据 
url 生成 Request.Builder 对 象 ， 继 续 调用 execute。 

execute: 首先 设置 请 求 头 信息 ， 一 般 没 有 特殊 要 求 都 不 需要 设置 请 求 ， 通 过 builder 对 象 的 
cacheControl 方法 设置 缓存 控制 ， 通 过 build 方法 生成 Request， 通 过 OkHttpClient 对 象 的 
newCall 方法 生成 一 个 call 对 象 ， 最 后 调用 enqueue 方法 进行 异步 请 求 ， 传 入 一 个 回调 接口 。 
MyHttpResponseHandler 类 继承 自己 写 的 HttpResponseHandler 抽 象 类 , 重 写 两 个 方法 onFailure 


与 onSuccess。 
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> onFailure (请 求 失败 后 调用 ) 先 从 map 中 删除 这 个 请 求 ， 打 印 错误 日 志 ， 发 送 回调 。 

> onSuccess (请 求 成 功 后 调用 ): 先 从 map 中 删除 这 个 请 求 ， 把 json 字符 串 转换 成 对 象 ， 发 
送 回调 。 

autoCancel: 从 map 中 删除 这 个 请 求 ， 调 用 Call.call 取消 http 请 求 。 

add: 有 两 个 同名 的 方法 ， 方 法 重 载 。 我 们 来 分 析 后 面 这 个 。 首 先 判断 这 个 url 是 否 为 空 ， 若 

为 空 则 什么 也 和 干 不 了 ， 然 后 需要 截取 前 面 的 信息 ， 不 然 参 数 不 一 致 将 无 法 判断 是 不 是 同一 时 

间 多 次 请 求 同 一 接口 了 。 接 下 来 判断 要 不 要 自动 取消 ， 最 后 存 入 map。 经 过 前 面 的 分 析 都 知 

道 发 起 get 请 求 时 会 调用 add 方法 将 call 请 求 保存 到 map 中 ,请 求 成 功 回调 中 会 将 call 从 map 

中 删除 。 假如 手机 网 络 状 态 不 稳定 ， 同 一 时 间 请 求 了 10 次 同一 个 接口 ， 都 没有 回调 回来 , 这 

也 是 为 什么 需要 在 添加 时 会 自动 取消 之 前 的 请 求 。 

clear: 从 map 中 删除 请 求 。 

printLog: 打印 日 志 。 

sendCallback: 有 两 个 方法 (方法 名 一 致 )， 这 里 用 到 了 方法 重 载 。 在 sendCallback 方法 中 将 

服务 器 返回 内 容 (byte 数组 )、 请 求 状态 、 用 GSON 包 解 析 JSON 后 的 对 象 这 三 个 值 封装 到 

CallbackMessage 对 象 中 ， 然 后 调用 handler. sendMessage 方法 将 CallbackMessage 对 象 发 给 自 

己 ， 其 实 就 是 把 服务 器 返回 结果 发 送 到 主线 程 中 ( 因为 我 们 用 的 是 异步 请 求 ， 通 过 前 面 章节 

我 们 知道 在 多 线程 中 无 法 更 新 UI )，Handler 的 handleMessage 方法 收 到 消息 之 后 ， 调 用 

CallbackMessage 对 象 的 callback 方法 。 


(3 ) Post 请 求 封装 

通过 以 上 对 HTTPCaller 类 各 个 方法 的 解释 ， 相 信 已 经 知道 Get 请 求 服务 器 的 整个 调用 流程 。 
现在 对 HTTPCaller 类 增加 Post 请 求 的 方法 以 及 上 传 文件 的 方法 。 对 postFile 方法 增加 了 
ProgressUIListener 参数 ， 通 过 这 个 接口 监听 上 传 文件 进度 的 回调 。 

public <T> void post (final Class<T> clazz, final String url, Header[] header, 
List<NameValuePair> params, final RequestDataCallback<T> callback) { 


this.post (clazz,url, header, params, callback,true); 
} 


Ww 


eparam clazz json 对 应 类 的 类 型 

eparam url 请 求 url 

@param header 请 求 头 

@param params 

eparam callback 回调 

eparam autoCancel 是 否 自动 取消 。true: 同 一 时 间 请 求 一 个 接口 多 次 ， 只 保留 最 后 一 个 


@param <T> 


3 


ws 
Public <T> void post (final Class<T> clazz,final String url, Header[] header, 
final List<NameValuePair> params, final RequestDataCallback<T> callback, boolean 
autoCancel) { 
if (checkAgent()) { 
return; 
} 
add (url,postBuilder (url, header, params, new 
HTTPCaller .MyHttpResponseHandler (clazz,url,callback)),autoCancel); 
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1 


Private Call PostBuilder (String url, Header[] header，List<NameValuePair> form, 
HttpResponseHandler responseCallback) { 
try { 
if (form == null) { 
form = new ArrayList<>(2); 
form.addAll (httpConfig.getCommonField() ) ;// 添 加 公共 字段 
FormBody.Builder formBuilder = new FormBody.Builder (); 
for (NameValuePair item : form) { 
formBuilder.add (item.getName () ，item.getValue () ) 7 
} 
RequestBody requestBody formBuilder.build(); 
Request.Builder builder = new Request.Builder(); 
builder.url (url); 
builder.post (requestBody); 
return execute (builder, header, responseCallback); 
} catch (Exception e) { 
if (responseCallback != null) 
responseCallback.onFailure(-1, e.getMessage() .getBytes()); 


} 


return null; 


* Q@param clazz json 对 应 类 的 类 型 
* Q@param url 请 求 url 

* Q@param header 请 求 头 

* Q@param form 请 求 参数 

* @param callback 回调 

* Q@param <T> 

家 


Public <T> void postFile (final Class<T> clazz, final String url, Header[] header, 
List<NameValuePair> form,final RequestDataCallback<T> callback) { 
postFile(url, header, form, new HTTPCaller.MyHttpResponseHandler 
(clazz,url, callback) ,null); 


灾 闪 
YE 三 作 
* @param clazz json 对 应 类 的 类 型 
* @param url 请 求 url 
* Q@param header 请 求 头 
* @param form 请 求 参数 
* @param callback 回调 
* Q@param progressUIListener 上 传 文件 进度 
* @param <T> 
sw 

Public <T> void postFile (final Class<T> clazz, final String url, Header[] header, 
List<NameValuePair> form,final RequestDataCallback<T> 
callback, ProgressUIListener progressUIListener) { 

add (url, postFile(url, header, form, new 

HTTPCaller.MyHttpResponseHandler (clazz, url,callback),progressUIListener)); 
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} 


/** 
上 传 文件 
Qparam 
Qparam 
Qparam 
@param 
@param 
@param 
Q@param 
Q@param 


:DE Te Te DE ET 


4 


S 


clazz json 对 应 类 的 类 型 
url 请 求 url 

header 请 求 头 

name 名 字 

fileName 文件 名 
fileContent 文件 内 容 
callback 回调 

<T> 


public <T> void postFile(final Class<T> clazz,final String url,Header[] 


header, String 


name,String fileName,byte[] fileContent,final 


RequestDataCallback<T> callback){ 
postFile(clazz,url,header,name, fileName, fileContent,callback,null); 


} 


A 如 
上 传 文件 
@param 
@param 
@param 
@param 
@param 
@param 
@param 
@param 
@param 


4 


YX 


clazz json 对 应 类 的 类 型 

url 请 求 url 

header 请 求 头 

name 名 字 

fileName 文件 名 

fileContent 文件 内 容 

callback 回调 
progressUIListener 回调 上 传 进度 
sD 


Public <T> void postFile(Class<T> clazz,final String url,Header[] 


header, String 


name, String fileName,byte[] fileContent,final 


RequestDataCallback<T> callback,ProgressUIListener progressUIListener) { 
add (url,postFile (url, header,name,fileName,fileContent,new 
HTTPCaller.MyHttpResponseHandler (clazz,url,callback) ,progressUIListener)); 


} 


Private Call postFile(String url, Header[] header,List<NameValuePair> 
form, HttpResponseHandler responseCallback,ProgressUIListener 
progressUIListener){ 


try { 


MultipartBody.Builder builder = new MultipartBody.Builder(); 
builder.setType (MultipartBody .FORM); 
MediaType mediaType = MediaType.parse("application/octet-stream"); 


form.addAll (httpConfig.getCommonField() ) ;// 添 加 公共 字段 


for (int i=form.size()-1;i>=0;i--){ 


NameValuePair item = form.get (i); 
if (item.isFile() ) {// 上 传 文件 
File myFile = new File(item.getValue()); 
if (myFile.exists()){ 
String fileName = Util.getFileName (item.getValue()); 
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builder.addFormDataPart (item.getName (), 


fileName,RequestBody. create (mediaType, myFile)); 


. 
}else{ 
builder.addFormDataPart (item.getName (), item.getValue()); 


RequestBody requestBody; 

if (progressUIListener==null) {// 不 需要 回调 进度 
requestBody=builder.build(); 

}else{// 需 要 回调 进度 
requestBody = ProgressHelper.withProgress (builder.build()， 


progressUIListener); 


} 


} 

Request.Builder requestBuider = new Request.Builder(); 
requestBuider.url (url); 

requestBuider.post (requestBody); 

return execute (requestBuider, header, responseCallback); 


} catch (Exception e) { 


e.PrintStackTrace (); 

Log.e (httpConfig.getTagName () ,e.toString())7 

if (responseCallback != null) 
responseCallback.onFailure(-1，e.getMessage () .getBytes () ) 


return null; 


Private Call postFile(String url, Header[] header,String name String 
filename,byte[] fileContent, HttpResponseHandler 
responseCallback, ProgressUIListener progressUIListener) { 


try { 


MultipartBody.Builder builder = new MultipartBody.Builder(); 
builder.setType (MultipartBody .FORM); 

MediaType mediaType = MediaType.parse ("application/octet-stream"); 
builder.addFormDataPart (name, filename, RequestBody.create (mediaType, 


fileContent)); 


List<NameValuePair> form = new ArrayList<>(2); 
form.addAll (httpConfig.getCommonField() ) ;// 添 加 公共 字段 
for (NameValuePair item : form) { 
builder.addFormDataPart (item.getName (),item.getValue ()); 
} 


RequestBody requestBody; 

if (progressUIListener==null) {// 不 需要 回调 进度 
requestBody=builder.build(); 

}else{// 需 要 回调 进度 
requestBody = ProgressHelper.withProgress (builder.build()， 

ProgressUIListener); 

} 

Request.Builder requestBuider = new Request.Builder(); 

requestBuider.url (url); 

requestBuider.post (requestBody); 

return execute (requestBuider, header,responseCallback); 
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} catch (Exception e) { 
if (httpConfig.isDebug()) { 
e.printSstackTrace (); 
Log.e (httpConfig.getTagName (), e.toString()); 


if (responseCallback != null) 
responseCallback.onFailure(-1, e.getMessage() .getBytes()); 
| 
return null; 


} 


(4) 增加 下 载 文件 的 方法 

get 请 求 与 post 请 求 都 有 了 ， 上 传 文件 就 是 post 请 求 , 继续 增加 downloadFile 方法 用 来 下 载 文 
件 , 通用 的 MyHttpResponseHandler 不 能 处 理 回调 , 又 增加 了 DownloadFileResponseHandler 类 处 理 
下 载 回调 。 


public void downloadFile(String url, String saveFilePath, Header[] header, 
ProgressUIListener progressUIListener) { 
downloadFile (url,saveFilePath, header, progressUIListener,true); 


Public void downloadFile(String url,String saveFilePath, Header[] header, 
ProgressUIListener progressUIListener,boolean autoCancel) { 
if (checkRgent ()) { 
return; 
add (url, downloadFileSendRequest (url, saveFilePath, header, 
progressUIListener), autoCancel); 
} 


Private Call downloadFileSendRequest (String url, final String saveFilePath, 
Header[] header, final ProgressUIListener progressUIListener){ 
Request .Builder builder = new Request.Builder(); 
builder.url (url); 
builder.get (); 
return execute(builder, header, new HTTPCaller.DownloadFileResponseHandler 
(url, saveFilePath,progressUIListener)); 
} 


Public class DownloadFileResponseHandler implements Callback { 
Private String saveFilePath; 
Private ProgressUIListener progressUIListener; 
Private String url; 


Public DownloadFileResponseHandler (String url,String saveFilePath, 
ProgressUIListener progressUIListener){ 
this.url=url; 
this.saveFilePath=saveFilePath; 
this.progressUIListener=progressUIListener; 
F 


QOverride 
Public void onFailure(Call call, IOException e) { 
clear (url); 
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| 
printLog(url +""+-1+""+new String(e.getMessage() .getBytes(), 
-utf=8"))» 
} catch (UnsupportedEncodingException encodingException) { 
encodingException.printStackTrace(); 
} 
1 


@Override 

Public void onResponse (Call call, Response response) throws IOException { 
printLog(url + " code:" + response.code()); 
clear (url); 


ResponseBody responseBody = ProgressHelper.withProgress 
(response.body(), progressUIListener); 
BufferedSource source = responseBody.source(); 


File outFile = new File(saveFilePath); 
outFile.delete(); 
outFile.createNewFile(); 


BufferedSink sink = Okio.buffer (Okio.sink (outFile)); 
source.readAll (sink); 

sink.flush(); 

source.close(); 


} 
RequestDataCallback 接口 封装 了 三 个 方法 ， 自 己 想 要 什么 数据 就 去 重 写 对 应 的 方法 。 


Public abstract class RequestDataCallback<T> { 
// 返 回 json 对 象 
Public void dataCallback(T obj) { 
} 


// 返 回 http 状态 和 json 对 象 

Public void dataCallback(int status, T obj) { 
dataCallback (obj) 

上 


// 返 回 http 状态 、json 对 象 和 http 原始 数据 

Public void dataCallback(int status, T obj，byte[] body) { 
dataCallback (status, obj); 

} 


Util 公共 类 有 三 个 静态 方法 。 


Public class Util { 
/三 
* 获取 文件 名 称 
* @param filename 
* @return 
区 
Public static String getFileName (String filename){ 
int start=filename.lastIndexOf ("/"); 
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3. OkHttp 封装 后 的 使 用 方法 
OkHttp 代码 都 封装 好 了 ， 我 们 在 Activity 中 如 何 调用 呢 ? 


(1) 依赖 
如 果 是 Android Studio 开发 工具 ， 我 们 封装 的 这 个 库 就 支持 在 线 依 赖 〈 已 经 将 项 目 添加 到 


jcenter) : 
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compile 'com.ansen.http:okhttpencapsulation:1.0.1' 


如 果 是 eclipse， 那 么 先 将 ide 切换 到 Android Studio。 不 嫌 麻 烦 的 话 ， 也 可 以 将 源码 module 的 
源码 复制 出 来 ， 反 正 也 就 几 个 类 。 
(2 ) 初始 化 HTTPCaller 类 
初始 化 的 工作 可 以 放 入 Application， 新 建 MyApplication 类 继承 Application。 初 始 化 时 通过 
HttpConfig 设置 一 些 参数 ， 也 可 以 添加 公共 参数 。 
Public class MyApplication extends Application{ 
@Override 


public void onCreate() { 
super.onCreate () 7 


HttpConfig httpConfig=new HttpConfig(); 

httpConfig.setAgent (true) ;// 有 代理 的 情况 能 不 能 访问 

httpConfig.setDebug (true) ;// 是 否 为 debug 模式 ， 如 果 是 debug 模式 ， 就 打印 日 志 
httpConfig.setTagName ("ansen"); // 打 印 日 志 的 tagname 


// 可 以 添加 一 些 公共 字段 ， 每 个 接口 都 会 带 上 
httpConfig.addCommonField ("pf","android"); 
httpConfig.addCommonField("version code", "1"); 


// 初 始 化 HTTPCaller 类 
HTTPCaller.getInstance () .setHttpConfig (httpConfig); 


} 


因为 自 定义 Application， 需 要 给 AndroidManifest.xml 文件 application 标签 中 的 android:name 
属性 赋值 ， 指 定 自己 重 写 的 MyApplication 。 


(3 ) 发 送 get 请 求 
发 送 get 请 求 只 需 以 下 一 行 代码 。 
HTTPCaller.getInstance () .get (User.class, 


"http://139.196.35.30:8080/OkHttpTest/getUserInfo.do?per=123"，null， 
requestDataCallback); 


(4) 请 求 回调 
http 请 求 回调 接口 , 无 论 成 功 或 者 失败 都 会 回调 。 因为 是 测试 , 所 以 都 用 在 这 个 接口 进行 回调 。 
在 真实 开发 中 ， 根 据 不 同 的 请 求 使 用 不 同 的 回调 。 


Private RequestDataCallback requestDataCallback = new 
RequestDataCallback<User>() { 
@Override 
public void dataCallback (User user) { 
if(user==null){ 
Log.i("ansen", "请 求 失败 ") ; 
yelse{ 
Log.i("ansen"，,， "获取 用 户 信息 :" + user.tostring()); 
1 


}; 
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(5 ) 发 送 post 请 求 
post 请 求 参数 不 是 跟 在 url 后 面 ， 所 以 需要 把 请 求 参数 放 到 集合 中 。 因 为 登录 接口 也 是 返回 的 
用 户 信息 ， 所 以 可 以 与 get 请 求 使 用 同一 回调 。 


List<NameValuePair> postParam = new ArrayList<>(); 

postParam.add (new NameValuePair ("username","ansen")); 

postParam.add (new NameValuePair ("password", "123")); 

HTTPCaller.getInstance () .post (User.class, "http://139.196.35.30:8080/ 
OkHttpTest/login.do", null, postParam, requestDataCallback); 


(6) 上 传 文件 
@ 上 传 文件 不 带 回调 进度 : 
updaloadFile (nul1); 


@ 上 传 文件 回调 上 传 进度 : 


updaloadFile (new ProgressUIListener(){ 
@Override 
Public void onUIProgressChanged (long numBytes, long totalBytes, float 
percent, float speed) { 
Log.i("ansen","numBytes:"+numBytes+" totalBytes:"+totalBytes+" 
Percent :"+Percent+" speed:"+speed); 
OR 


上 传 文件 与 其 他 表单 参数 不 一 样 的 地 方 就 是 新 建 NameValuePair 对 象 时 需要 传 入 三 个 参数 ,最 
后 一 个 参数 需要 设置 成 true。 


Private void updaloadFile (ProgressUIListener progressUIListener){ 
List<NameValuePair> PostParam = new ArrayList<>(); 
postParam.add (new NameValuePair("username", "ansen") ) 
PostParam.add (new NameValuePair ("Password"，"123") ) 
String filePath=copyFile();// 复 制 一 份 文件 到 sdcard 上 ， 并 且 获 取 文 件 路 径 
postParam.add (new NameValuePair ("upload file",filePath,true)); 
if (progressUIListener==null1) {// 上 传 文件 没有 回调 进度 条 
HTTPCaller.getInstance () .postFile (User.class, "http://139.196.35.30: 
8080/0kHttpTest/uploadFile.do", null, postParam, requestDataCallback); 
}else{// 上 传 文件 并 且 回 调 上 传 进度 
HTTPCaller.getInstance () .postFile(User.class, "http://139.196.35.30: 
8080/0kHttpTest/uploadFile.do", null, postParam, 
requestDataCallback,progressUIListener); 


1 


(7) 上 传 文件 ( 传 入 byte 数组 ) 


byte[] bytes=getUploadFileBytes();// 获 取 文 件 内 容 存 入 byte 数组 
HTTPCaller.getInstance () .postFile(User.class, 
"http://139.196.35.30:8080/0kHttpTest/uploadFile.do", null, 
"upload file","test.txt",bytes,requestDataCallback); 


(8) 上 传 文件 ( 传 入 byte 数组 ) && 回 调 上 传 进度 


byte[] bytes=getUploadFileBytes () ;// 获 取 文件 内 容 存 入 byte 数组 
HTTPCaller.getInstance () .postFile(User.class, 
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"http://139.196.35.30:8080/0kHttpTest/uploadFile.do", null, "upload file", 
"test.txt", bytes, requestDataCallback, new ProgressUIListener() { 
@Override 
Public void onUIProgressChanged(long numBytes, long totalBytes, float 
percent, float speed) { 
Log.i("ansen","upload file content numBytes:"+numBytes+" 
totalBytes:"t+totalBytes+" percent:"+percent+" speed:"+speed); 
} 
DD); 
(9) 下 载 文件 && 回 调 下 载 进度 
String saveFilePath=Environment .getExternalStorageDirectory() + 
"/test/test222.txt"; 
HTTPCaller.getInstance () .downloadFile("http://139.196.35.30:8080/0kHttpTes 
t/upload/test.txt",saveFilePath,null,new ProgressUIListener () 1{ 
@Override 
Public void onUIProgressChanged (long numBytes, long totalBytes, float 
percent, float speed) { 
Log.i("ansen","dowload file content numBytes:"+numBytes+" 
totalBytes:"+totalBytes+" percent:"+percent+" speed:"+speed); 
} 
Ds 
(10) 修改 公共 参数 


HTTPCaller .getInstance() .updateCommonField ("version code", "2");// 更 新 公共 字段 版 
本 号 的 值 


6.2 ”数据 存储 


当 我 们 开发 一 个 产品 级 App 时 ， 有 时 需要 在 手机 本 地 保存 一 些 数据 ， 例 如 用 户 登 录 后 的 用 户 
信息 ， 这 样 的 好 处 就 是 当 手 机 没有 网 络 时 打开 App 也 能 看 到 用 户 信息 。 
在 Android 中 ， 本 地 数据 存储 主要 有 SharedPreferences、SQLite 数据 库 、 文 件 存 储 三 种 方式 。 


6.2.1 SharedPreferences 


SharedPreferences 以 键 值 对 的 形式 存储 在 xml 文件 中 ， 存 储 文件 路 径 位 于 “/data/data/ 应 用 程 
序 包 /shared_pre 人 ”目录 下 。 正 常情 况 下 ， 其 他 应 用 程序 没有 操作 权限 ， 所 以 相对 比较 安全 。 当 然 
用 户 卸 载 App 或 者 系统 设置 里 清除 应 用 数据 都 会 将 SharedPreferences 文件 删除 。 
SharedPreferences 可 以 存 一 些 简单 的 数据 ， 例 如 用 户 登 录 状 态 、 登 录 后 用 户 信息 等 。 
1. 获取 SharedPreferences 的 两 种 方式 
@ 调用 Context 对 象 的 getSharedPreferences() 方 法 : 调用 Context 对 象 的 getSharedPreferences() 
方法 获得 的 SharedPreferences 对 象 可 以 被 同一 应 用 程序 下 的 其 他 组 件 共 享 。 
@ 调用 Activity 对 象 的 getPreferences() 方 法 : 调用 Activity 对 象 的 getPreferences() 方 法 获得 的 
SharedPreferences 对 象 只 能 在 该 Activity 中 使 用 。 
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2. 调用 Context 对 象 的 getSharedPreferences() 方 法 的 代码 
在 工作 中 可 能 会 存储 用 户 登录 成 功 后 的 信息 和 登录 状态 ， 这 时 可 以 使 用 SharedPreferences 进 
行 存储 。 
首先 通过 Context 的 getSharedPreferences 方法 获取 SharedPreferences 对 象 ,需要 传 入 两 个 参数 : 
第 一 个 是 文件 名 ， 第 二 个 是 操作 模式 。 操 作 模式 有 以 下 几 种 : 
e@ ContextMODE _ PRIVATE: 默认 操作 模式 ， 代 表 该 文件 是 私有 数据 ， 只 能 被 应 用 本 身 访问 。 
在 该 模式 下 ， 写 入 的 内 容 会 覆盖 原文 件 的 内 容 。 
”Context.MODE_APPEND: 该 模式 会 检查 文件 是 否 存 在 ， 若 存在 就 向 文件 中 追加 内 容 ， 否 则 
创建 新 文件 。 
Context.MODE_WORLD_READABLE: 表示 当前 文件 可 以 被 其 他 应 用 读 取 。 
Context.MODE_WORLD_WRITEABLE: 表示 当前 文件 可 以 被 其 他 应 用 写 入 。 


如 果 是 存储 数据 ， 还 需要 获取 SharedPreferences 的 内 部 类 Editor， 通 过 Editor 来 put 数据 ， 支 
持 常 用 的 String、int、boolean 、float、long、Set 集合 。 最 后 记得 调用 commit 方法 进行 提交 。 以 下 
代码 是 存储 一 个 用 户 名 : 

SharedPreferences 
sp=getApplicationContext () .getSharedPreferences ("filename", 
Context .MODE PRIVATE); 

SharedPreferences.Editor edit=sp.edit (); 

edit.putSstring ("username", "ansen"); 

edit.commit (); 

上 一 步 存储 了 username， 那 么 肯定 会 想 办 法 提取 出 来 ， 不 然 存储 就 变 得 没有 意义 。 首 先是 获 
取 SharedPreferences 对 象 , 然后 调用 getString 方法 获取 , 第 一 个 参数 是 key, 第 二 个 参数 是 默认 值 ， 
也 就 是 如 果 username 没有 找到 就 返回 第 二 个 参数 。 

SharedPreferences 
sp=getApplicationContext () .getSharedPreferences ("filename", 


Context .MODE PRIVATE); 
String username=sp.getString ("username", ""); 


6.2.2 SQLite 数据 库 


SQLite 是 一 款 轻型 的 数据 库 ， 设 计 目标 是 嵌入 式 的 ， 而 且 目 前 已 经 在 很 多 嵌入 式 产品 中 使 用 
了 它 。 它 占用 资源 非常 低 ， 在 嵌入 式 设备 中 ， 可 能 只 需要 几 百 千 字 节 的 内 存 就 够 了 。 它 支持 
Windows/Linux/UNIX 等 主流 的 操作 系统 ， 同 时 能 够 与 很 多 程序 语言 相 结 合 ， 比 如 C#、PHP、Java 
等 ， 还 提供 ODBC 接口 。 比 起 Mysql、PostgreSQL 这 两 款 开源 的 世界 著名 数据 库 管 理 系统 ， 它 的 
处 理 速度 更 快 。 SQLite 第 一 个 Alpha 版 本 诞生 于 2000 年 5 月 , 至 2015 年 已 经 有 15 个 年 头 , SQLite 
又 迎 来 了 一 个 版 本 SQLite3。 

1. SQLite 优点 


SQLite 具有 以 下 优点 : 
(1) 轻 量 级 : SQLite 和 C/S 模式 的 数据 库 软件 不 同 ， 它 是 进程 内 的 数据 库 引 擎 ， 因 此 不 存在 
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数据 库 的 客户 端 和 服务 器 。 使 用 SQLite 一 般 只 需要 带 上 它 的 一 个 动态 库 ， 就 可 以 享受 它 的 全 部 功 
能 ,而且 那 个 动态 库 的 尺寸 也 挺 小 , 以 版 本 3.6.11 为 例 , Windows 下 为 487KB、Linux 下 为 347KB。 

(2) 不 需要 “安装 ”: SQLite 的 核心 引擎 本 身 不 依赖 第 三 方 的 软件 , 使 用 它 也 不 需要 “安装 ”， 
有 点 类 似 绿色 软件 。 

(3) 单一 文件 : 数据 库 中 所 有 的 信息 〈 比 如 表 、 视 图 等 ) 都 包含 在 一 个 文件 内 。 这 个 文件 可 
以 自由 复制 到 其 他 目录 或 机 器 上 。 

(4) 跨 平台 /可 移植 性 ， 除了 主流 操作 系统 Windows、Linux 之 后 ，SQLite 还 支持 其 他 一 些 不 
常用 的 操作 系统 。 

(5) 弱 类 型 的 字段 : 同一 列 中 的 数据 可 以 是 不 同类 型 。 

(6) 开源 : 源码 完全 开源 ， 可 以 用 于 任何 用 途 ， 包 括 出 售 。 

SQLite 可 以 存 相 对 多 一 点 的 数据 ， 例 如 QQ， 可 以 把 用 户 之 前 的 聊天 记录 保存 在 本 地 SQLite 
数据 库 中 。 


2. 在 Android 中 使 用 SQlite 数据 库 


Android 系统 自 带 了 SQLite 数据 库 ， 所 以 Google 封装 了 操作 SQLite 数据 库 的 API， 包 含 在 
android.database.sqlite 包 下 。 

首先 重 写 一 个 类 SQLiteHelper， 需 要 继承 SQLiteOpenHelper 类 ; 重 写 两 个 方法 onCreate 与 
onUpgrade， 这 两 个 方法 的 作用 都 有 注释 ， 相 信 一 看 就 懂 。 


public class SQLiteHelper extends SQLiteOpenHelpert{ 
private static final int VERSION = 1;// 数 据 库 版 本 号 
private static String db name="test";// 数 据 库 名 称 


public SQLiteHelper (Context context) { 
super (context, db name, null, VERSION); 
} 


// 当 第 一 次 建 库 的 时 候 ， 调 用 该 方法 

@Override 

Public void onCreate (SQLiteDatabase db) { 
// 创 建 数据 库 的 时 候 把 学 生 表 创建 好 
String sql = "create table user(id int,name varchar (20) ,age int)"; 
db .execSQL (sql) 7 


Log.i("SQLiteHelper", "onCreate..... i 
上 


// 当 更 新 数据 库 版 本 号 的 时 候 就 会 执行 该 方法 
@Override 
public void onUpgrade (SQLiteDatabase sqLiteDatabase, int oldVersion, int 
newVersion) { 
Log.i("SQLiteHelper", "update Database..... i 
| 


创建 数据 库 ， 只 需要 实例 化 SQLiteHelper 类 即 可 【第 一 次 会 调用 oncreate 方法 ， 这 时 创建 好 
学 生 表 ) ， 再 通过 getReadableDatabase 方法 获取 SQLiteDatabase 对 象 ， 对 数据 库 的 增加 、 删 除 、 
修改 、 查 找 都 需要 这 个 实例 来 实现 。 
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Public void createDb (View view){ 
SQLiteHelper sqLiteHelper=new SQLiteHelper (this); 
sqLiteDatabase=sqLiteHelper.getReadableDatabase (); 
} 


向 学 生 表 增 加 一 条 记录 的 操作 如 下 : 


public void addRecord (View view){ 
ContentValues values = new ContentValues (); 
// 参 数 1: 表 的 字段 参数 2: 字 段 对 应 的 值 
values.put ("id",1); 
values.put ("name", "test1"); 
values.put ("age",11); 
// 参 数 1: 表 名 参数 3: 插 入 的 数据 


sqLiteDatabase.insert ("user",null,values); 


Log.i("MainActivity", " 往 学 生 表 添加 一 条 数据 ") ; 
} 


更 新 记录 ， 将 用 户 表 name="testl" 的 记录 年 龄 修改 成 88: 


Public void updateRecord (View view){ 
Log.i("MainActivity","updateRecord"); 


ContentValues contentValues = new ContentValues(); 
contentValues.put ("age", "88"); 
/ /参数 1: 表 名 参数 2 :修改 的 值 参数 3 :查询 条 件 参数 4: 查 询 条件 需 要 的 参数 
sqLiteDatabase.update ("user", contentValues, "name=?", new 
String[]{"test1"}); 
} 


查找 用 户 表 所 有 数据 ， 并 且 打 印 出 来 : 


public void findStudent (View view){ 
Cursor cursor=sqLiteDatabase.query ("user",new 
String[]{"id","name", "age"},null,null,null,null,null1); 
while (cursor.moveToNext () ) {// 判 断 下 一 条 有 没有 数据 
int id = cursor.getInt (0); 
String name = cursor.getString(1); 
int age = cursor.getInt (2); 
Log.i("MainActivity","id:"+id+" name:"+name+" age:"+tage); 
} 
cursor.close(); 
1 


删除 一 条 记录 的 操作 如 下 : 
Public void delete(View view){ 
sqLiteDatabase.delete ("user", "name=?",new String[]{"test1"}); 
Log .i ("MainActivity", "删除 一 条 数据 "); 
这 里 使 用 系统 API 给 大 家 讲解 了 数据 库 的 增加 、 删 除 、 修 改 与 查找 ， 也 是 在 工作 中 常用 的 方 
式 ， 但 是 有 些 复杂 的 查询 还 需要 手动 去 写 SQL 语句 。SQLiteDatabase 本 身 支持 执行 SQL， 调 用 
execSQL 方法 即 可 ， 有 需要 时 可 上 网 去 学 习 。 
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6.2.3 ”文件 存储 

在 Android 中 ， 文 件 存储 一 般 有 两 种 选择 ，SD 卡 目录 或 者 应 用 程序 下 的 存储 目录 。 两 者 之 间 
的 比较 如 下 : 

® SD 卡 目录 : 应 用 程序 印 载 了 ,之 前 创建 的 文件 还 在 ,通常 手机 SD 卡 的 内 存 很 大 , 有 16GB、 


32GB、64GB 等 。 
@ ”应 用 程序 下 的 存储 目录 : 存储 内 存 很 小 ， 应 用 程序 删除 了 ， 之 前 创建 的 文件 也 会 删除 。 
1. SD 卡 目录 


首先 判断 有 没有 SD 卡 ， 然 后 获取 SD 卡 目录 。 

if(Environment .getExternalStorageState() .equals (Environment .MEDIA MOUNTED)) { 

// 判 断 有 没有 sdcard 
File sdCard = Environment .getExternalStorageDirectory(); 
Log.i("MainActivity",sdCard.getPath()); 

1 

打印 的 日 志 如 下 : 

I/MainActivity: /storage/emulated/0 


2. 应 用 程序 下 的 存储 目录 


File getFilesDir =getFilesDir() 
Log.i("MainActivity",getFilesDir.getPath()); 


打印 的 日 志 如 下 : 
I/MainActivity: /data/data/com.ansen.sdcard/files 
为 了 正常 读 取 SD 卡 ， 需 要 在 AndroidManifest.xml 中 声明 读 写 权 限 : 


<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE"/> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE"/> 


6.3 本章 小 结 


本 章 主 要 学 习 了 Android 平台 的 HTTP 通信 与 数据 存储 。 

HTTP 协议 请 求 数 据 主要 用 到 了 HttpURLConnection 类 ， 还 有 两 种 请 求 方式 : Get 请 求 与 Post 
请 求 。 现 在 主流 的 应 用 程序 前 后 端 交互 数据 基本 都 用 JSON， 我 们 学 习 了 Google 开源 库 GSON 的 
使 用 ， 最 后 学 习 了 Android 网 络 开源 框架 OkHttp 的 使 用 ， 并 对 OkHttp 进一步 封装 。 

数据 存储 主要 学 习 了 三 种 主要 的 存储 方式 : SharedPreferences 键 值 对 存储 、SQLite 数据 库存 储 
以 及 文件 存储 (主要 存储 在 SD 卡 上 ) 。SharedPreferences 和 SQLite 存储 的 内 容 与 应 用 程序 的 生命 
周期 一 致 ， 程 序 卸 载 后 数据 就 没有 了 。 存 储 在 SD 卡 上 的 文件 即使 程序 卸载 了 也 会 存在 。 


Android 高 级 应 用 


本 章 内 容 比较 丰富 ， 并 且 知 识 点 相对 前 面 的 章节 来 说 稍微 难 一 点 ， 是 一 些 必 须要 掌握 的 内 容 
但 是 又 不 常用 。 首 先 介绍 Notification 〈 通 知 ) 的 使 用 ， 使 用 Notification 让 我 们 的 App 在 后 台 也 能 
通知 用 户 ， 让 应 用 程序 (App) 更 人 性 化 。 同 时 介绍 多 媒体 开发 ， 调 用 官方 API， 简 单 播放 音 视 频 
只 需 几 行 代码 就 能 完成 ， 后 面 还 将 介绍 WebView， 在 原生 App 中 嵌入 网 页 ; 通过 NDK 工具 ， 使 
用 jni 技 术 ， 使 Android 和 C++ 能 够 进行 交互 。 最 后 是 SourceTree (Git 可视化 ) 工具 ， 从 此 不 再 需 
要 记 住 很 长 的 Git 命令。 





7.1 Notification (通知 ) 使 用 


通知 是 显示 在 应 用 外 的 UI 界面 ， 当 你 的 App 向 系统 发 送 一 个 通知 时 , 先 以 图 标的 形式 显示 在 
通知 区 域 中 ， 如 图 7-1 所 示 。 用 户 可 以 下 拉 通 知 栏 查看 通知 的 详细 信息 ， 如 图 7-2 所 示 。 通 知 栏 是 
由 系统 控制 的 ， 用 户 可 以 随便 查看 。 





Google 


7-1 通知 区 域 中 的 通知 
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需要 显示 通知 的 场景 有 很 多 ， 例 如 收 到 短信 、 邮 箱 时 通过 通知 栏 提醒 用 户 ， 


曲 ， 通 知 栏 显示 下 载 进度 等 。 


7.1.1 创建 通知 





The Big Meeting 
415 - 5:15 PM 


一 swArtcus 


New Googler notifications 
EarlLibyrd: Added you back 


加 screenshot captured. 


Touch to view your screenshot 


@ Keep photos & videos backed. 


Touch to get free private storage on Google 


3 new messages 411PM 
ye 
kumlatar swankatranami@gmailcom 


3 new messages 
754) 263-8267, 456 


图 7-2 下 拉 通 知 栏 显示 通知 列表 


音乐 App 下 载 歌 


首先 我 们 创建 一 个 通知 ， 通 过 NotificationCompat.Builder 对 象 操作 通知 的 U1。 要 创建 通知 ， 


将 调用 NotificationCompat.Builder.build() ， 


返回 具体 的 Notification 对 象 


NotificationManager.notify() 向 系统 发 出 通知 。 


设置 通知 内 容 一 


会 调用 以 下 三 个 方法 : 


@ setSmallIcon: 设置 小 图 标 。 


@ setContentTitle: 设置 标题 。 
@ setContentText: 设置 内 容 。 


我 们 创建 一 个 简单 的 通知 ， 代 码 如 下 : 


NotificationCompat.Builder mBuilder = 

new NotificationCompat .Builder (this) 
.setsmallIcon (R.mipmap.ic launcher) // 小 图 标 
.SetContentTitle ("标题 ") 
.SetContentText ("内 容 "); 


Intent intent=new Intent (this,NotificationActivity.class); 
PendingIntent ClickPending = PendingIntent.getRActivity(this，0， 


。 最 后 调用 


intent, 0); 
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mBuilder.setContentIntent (ClickPending); 
mBuilder.setAutoCancel (true) ;// 点 击 这 条 通知 自动 从 通知 栏 中 取消 


NotificationManager mNotificationManager = 
(NotificationManager) getSystemService (Context.NOTIFICRTION SERVICE) ; 
mNotificationManager.notify(id, mBuilder.build()); 

最 后 一 行 代码 调用 notify 方法 向 系统 发 送 一 个 通知 , 这 个 方法 有 两 个 参数 : 第 一 个 参数 是 通知 
的 唯一 ID， 我 们 可 以 通过 这 个 ID 来 修改 /删除 当前 通知 ;第 
二 个 参数 是 Notification 对 象 , 通过 NotificationCompat.Builder 
的 build 方法 获取 。 

运行 效果 如 图 7-3 所 示 。 








7.1.2 ”通知 优先 级 


我 们 可 以 通过 代码 来 设置 通知 的 优先 级 ， 优 先 级 相当 于 
-个 提示 ， 提 醒 手 机 如 何 显示 通知 。 调 用 NotificationCompat. 
Builder.setPriority() 并 传 入 一 个 NotificationCompat 优先 级 常 
里 。 
有 5 个 优先 级 别 ， 范 围 从 PRIORITY_MIN (-2) 到 
PRIORITY MAX (2)， 如 果 未 设置 ， 则 优先 级 默认 为 
PRIORITY _ DEFAULT (0)。 


删除 通知 


图 7-3 创建 一 个 简单 的 通知 


7.1.3 ”更 新 通知 


更 新 通知 与 创建 通知 调用 的 方法 是 一 样 的 ， 都 是 调用 notify0， 这 个 方法 的 第 一 个 参数 与 创建 
时 传 入 的 ID 一 致 即 可 ,只 需要 更 新 或 创建 NotificationCompat.Builder 对 象 。 如 果 这 个 ID 之 前 已 经 
存在 通知 ,那么 系统 就 会 更 新 之 前 的 通知 ; 如 果 之 前 通知 已 取消 或 者 未 创建 ， 系 统 就 会 创建 一 个 新 
通知 。 

写 一 个 简单 的 例子 ， 每 次 更 新 通知 栏 的 次 数 进 行 累 加 显示 出 来 。 下 面 这 段 代 码 与 创建 通知 栏 
的 代码 几乎 一 样 ， 改 变 的 只 是 NotificationCompat.Builder 对 象 的 内 容 。 

NotificationCompat.Builder mBuilder = 

new NotificationCompat.Builder (this) 

.setsmallIcon (R.mipmap.ic launcher) // 小 图 标 


.SetContentTitle ("更 新 通知 -标题 "+ (++number)) 
.SetContentText ("更 新 通知 -内 容 ") .setNumber (number); 


Intent intent=new Intent (this,NotificationActivity.class); 
PendingIntent ClickPending = PendingIntent .getActivity(this, 0, intent, 0); 
mBuilder .setContentIntent (ClickPending); 


NotificationManager mNotificationManager = 
(NotificationManager) getSystemService (Context.NOTIFICATION SERVICE); 
mNotificationManager.notify(id, mBuilder.build()); 
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7.1.4 删除 通知 


使 用 代码 删除 通知 有 以 下 几 种 方法 : 

日 ”创建 通知 时 调用 setAutoCancel(true) 方 法 ， 这 样 当 用 户 点 击 这 条 通知 时 会 从 通知 栏 自动 删除 。 
@ 根据 ID 删除 这 条 通知 ， 调 用 NotificationManager.cancel(int id) 方 法 。 

@ 删除 所 有 通知 ， 调 用 NotificationManager.cancelAll() 方 法 。 


7.1.5 自 定义 通知 布局 


系统 的 通知 栏 样式 有 很 多 缺点 ， 首 先 各 个 版 本 的 样式 不 一 致 ， 各 种 手机 的 样式 也 不 统一 ， 国 
内 手机 厂商 定制 严重 , 但 是 又 想 统一 样式 怎么 办 呢 ? 谷歌 早 帮 有 我 们 想 好 了 , 让 我 们 自己 去 自 定义 通 
知 栏 显 示 的 布局 文件 ， 通 过 xml 文件 想 怎 么 设计 就 怎么 设计 。 

自 定义 布局 通知 栏 的 可 用 高 度 取决 于 通知 视图 ,一般 布局 限制 为 64dp, 最 高 可 用 设置 为 256dp。 

首先 创建 layout_custom_notification.xml 文件 ， 其 中 包含 三 个 控件 ，icon、 标 题 、 内 容 。 

<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match Parent" 
android:layout height="wrap content"> 





<ImageView 
android:id="@+id/imageview" 
android:layout width="wrap content" 
android:layout height="wrap content"/> 


<TextView 
android:id="@+id/tv title" 
android:layout alignParentRight="true" 
android:layout width="wrap content" 
android:layout height="wrap content"/> 


<TextView 

android:id="@+id/tv content" 

android:layout below="@+id/tv title" 

android:layout marginTop="10dp" 

android:layout alignParentRight="true" 

android:layout width="wrap_content" 

android:layout height="wrap content"/> 
</RelativeLayout> 


我 们 来 看 看 Java 代码 是 如 何 实现 的 : 


//RemoteViews 加 载 xml 

RemoteViews remoteViews = new RemoteViews (getPackageName(), 
R.layout.layout custom notification); 

// 设 置 图 片 ， 参数 1 是 xml 中 ImageView 设置 的 id， 参数 2 是 资源 id 

remoteViews.setImageViewResource (R.id.imageview,R.mipmap.ic launcher); 

remoteViews.setTextViewText (R.id.tv title, "这 是 标题 "); 

remoteViews.setTextViewText (R.id.tv_ content, "这 是 内 容 ") ; 
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Intent intent=new Intent (this,NotificationActivity.class); 
PendingIntent clickIntent = PendingIntent.getActivity(this, 0, intent, 0); 


Notification notification = new Notification(); 

// 必 须要 设置 一 个 图 标 ， 通知 区 域 中 需要 显示 

notification.icon = android.R.drawable.ic media Play7 

notification.contentView = remoteViews;// 自 定义 布局 

notification.contentIntent = clickIntent;// 点 击 跳 转 Intent 

NotificationManager mNotificationManager = (NotificationManager) 
getSystemService (Context .NOTIFICATION SERVICE); 

mNotificationManager.notify(id, notification); 


与 之 前 的 不 同 ， 这 里 没有 创建 NotificationCompat Builder 对 象 ， 而 是 构造 一 个 RemoteViews 
对 象 ， 这 个 类 的 构造 方法 有 两 个 参数 , 包 名 与 布局 文件 id, 调用 setImageViewResource 方法 设置 图 
片 资源 ， 调 用 setTextViewText 方法 设置 文本 内 容 。 接 下 来 构造 Notification 对 象 ， 设 置 通知 区 域 显 


行 代码 ， 效 果 如 图 7-4 所 示 。 


8:54 sem 


渍 





自 定义 通知 


图 74 自 定 义 通知 
7.2 ”多 媒体 开发 


多 媒体 (Multimedia) 是 多 种 媒体 的 综合 ， 一 般 包括 文本 、 声 音 和 图 像 等 多 种 媒体 形式 。 
在 移动 设备 上 ， 随 着 性 能 的 提高 、 宽 带 的 增长 、 流 量 的 提升 ， 音 频 跟 视频 的 使 用 场景 非常 多 ， 
本 节 就 使 用 Android SDK 自 带 的 API 实现 音 视频 的 播放 。 


7.2.1 播放 音频 


音乐 播放 器 是 手机 中 最 常见 的 应 用 , 基本 每 一 部 Android 手机 都 有 自 带 的 音乐 播放 器 ， 有 时 我 
们 开发 的 App 也 有 播放 音乐 的 需求 ， 例 如 播放 一 段 提示 音 。 因 此 ， 学 习 在 Android 手机 上 播放 音乐 
是 非常 有 必要 的 ， 本 小 节 学 习 一 些 基本 知识 , 例如 音乐 播放 、 拖 动 进度 条 、 和 暂停 播放 、 继 续 播放 等 。 
新 建 项 目 ， 首 先 修改 布局 文件 activity_main.xml: 
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<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:padding="10dp" 
android:orientation="vertical"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 


android:text=" 歌 曲名 称 :成 都 "/> 


<RelativeLayout 
android:layout marginTop="10dp" 
android:layout marginBottom="10dp" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<TextView 
android:id="@+id/tv start time" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:text="00:00:00"/> 


<SeekBar 
android:id="@+id/seekbar" 
android:layout toRightOf="@+id/tv start time" 
android:layout toLeftOf="@+id/tv end time" 
android:layout width="match parent" 
android:layout height="wrap content" /> 












<TextView 

android:id="@+id/tv end time" 
android:layout alignParentRight="true" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:text="00:00:00"/> 

</RelativeLayout> 





<ImageView 
android:id="@+id/iv play" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:src="@mipmap/icon play"/> 
</LinearLayout> 
最 外 层 是 一 个 LinearLayout 垂直 排列 ) ， 最 上 面 的 TextView 显示 歌曲 名 称 ， 中 间 的 
RelativeLayout 用 来 设置 开始 时 间 和 结束 时 间 ， 还 有 一 个 SeekBar 用 来 显示 播放 的 进度 ， 并 且 能 
动 进度 条 。 底 部 的 ImageView 用 来 点 击 播放 或 暂停 。 
布局 文件 对 应 的 MainActivityjava 内 容 如 下 : 


public class MainActivity extends AppCompatActivity { 
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private boolean isPlay=false;// 播 放 状态 true: 播 放 false: 未 播放 
private boolean isPause=false;// 暂 停 状态 true: 暂 停 false: 未 暂停 


Private MediaPlayer mediaPlayer; 
Private ImageView ivPlay; 
Private SeekBar seekBar; 


Private Handler handler=new Handler(); 
private TextView tvStartTime,tvEndTime;// 开 始 时 间 与 结束 时 间 


Private final Runnable mTicker = new Runnable(){ 
public void run() { 
long now = SystemClock.uptimeMillis(); 
long next = now + (1000 - now 当 1000); 


handler .postAtTime (mTicker,next); 


/ /延迟 一 秒 再 次 执行 runnable, 与 计时 器 效果 一 样 


if(mediaPlayer!=null&&isPlay&&l!isPause)1{ 
SeekBar.setProgress (mediaPlayer.getCurrentPosition());//. 更 新 播放 进度 


tvVStartTime .setText (getTimeStr (mediaPlayer.getCurrentPosition())); 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 
setContentView(R.layout.activity main); 


ivPlay= (ImageView) findViewById(R.id.iv play); 
ivPlay.setOnClickListener (onClickListener); 

seekBar= (SeekBar) findViewById(R.id.seekbar); 
seekBar.setOnSeekBarChangeListener (onSeekBarChangeListener); 


//seekbar 改变 监听 


tvStartTime= (TextView) findViewById(R.id.tv start time); 
tvEndTime= (TextView) findViewById(R.id.tv end time); 
} 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.iv play: 
if(isPlay){ 
if (isPause) {// 暂 停 中 
mediaPlayer.start () ;// 开 始 播放 
isPause=false;// 
ivPlay.setImageResource(R.mipmap.icon stop); 
handler .post (mTicker) ;// 更 新 进度 
}else{// 未 暂停 
mediaPlayer.pause() ;// 暂 停 播 放 
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isPause=true; 
ivPlay.setImageResource (R.mipmap.icon play); 
handler.removeCallbacks (mTicker); 
// 删 除 执行 的 Runnable 终止 计时 器 
} 
J}else{ 
PlayMusic () ;// 播 放 音 乐 
ivPlay.setImageResource(R.mipmap.icon stop); 
isPlay=true; 
} 


break; 


Private void playMusic(){ 
try { 
mediaPlayer= new MediaPlayer() 
Uri uri = 
Uri.parse("android.resource://com.ansen.playmusic/"+R.raw. chengdu); 
mediaPlayer.setDataSource (MainActivity.this,uri); 

// 设 置 播放 资源 (可 以 是 应 用 的 资源 文件 /url / sdcard 路 径 ) 
mediaPlayer.setAudioStreamType (AudioManager .STREAM MUSIC) ; // 设 置 播 放 类 型 
mediaPlayer.setOnCompletionListener (onCompletionListener) ;// 播 放 完成 监听 
mediaPlayer.setOnPreparedListener (new 

MediaPlayer.OnPreparedListener () {// 预 加 载 监 听 
@Override 
public void onPrepared (MediaPlayer mp) {// 预 加 载 完 成 
seekBar.setMax (mediaPlayer.getDuration () ) ;// 设 置 总 进度 
mediaPlayer.start() ;// 开 始 播放 
handler.post (mTicker) ;// 更 新 进度 
tvEndTime .setText (getTimeStr (mediaPlayer.getDuration())); 
上 
Ds; 
mediaPlayer .prepare (); 
} catch (IOException e) { 
e.PrintStackTrace (); 
} 


private SeekBar.OnSeekBarChangeListener onSeekBarChangeListener=new 


SeekBar.OnSeekBarChangeListener() { 


@Override 
Public void onProgressChanged (SeekBar seekBar, int progress, boolean 


fromUser) {// 进 度 改 变 
j 


@Override 
public void onStartTrackingTouch (SeekBar seekBar) {// 开 始 拖 动 seekbar 


. 


@Override 
public void onStopTrackingTouch (SeekBar seekBar) {// 停 止 拖 动 seekbar 


if (mediaPlayer!=null&g&isPlay) {// 播 放 中 
mediaPlayer.seekTo (seekBar .getProgress ()); 
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private MediaPlayer.OnCompletionListener onCompletionListener=new 
MediaPlayer.OnCompletionListener() { 
@Override 
public void onCompletion (MediaPlayer mp) { 
// 播 放 完 成 ， 进 入 暂停 状态 ， 恢 复 初 始 值 
isPause=true; 
ivPlay.setImageResource(R.mipmap.icon play); 
mediaPlayer.seekTo (0); 
seekBar.setProgress (0); 
tvStartTime.setText ("00:00:00"); 
handler.removeCallbacks (mTicker) ;// 删 除 执行 的 Runnable， 终 止 计 时 器 


@Override 
protected void onDestroy() { 
if (mediaPlayer!=nul1) {// 如 果 不 为 空 ， 有 释 放 资 源 
mediaPlayer.stop(); 
mediaPlayer.reset (); 
mediaPlayer.release(); 
mediaPlayer = null; 
} 
super.onDestroy(); 
. 


六 大 

* @param time 时 间 戳 

* @return 分 秒 字符 串 

x 

Private String getTimeStr(long time){ 
SimpleDateFormat simpleDateFormat=new SimpleDateFormat ("mm:ss"); 
return simpleDateFormat.format (time); 


onCreate: Activity 的 入 口 ， 查 找 控件 ， 给 ivPlay 设置 点 击 监听 ， 给 seekBar 设置 改变 监听 。 
onClickListener: 播放 按钮 的 回调 ， 远 辑 稍微 复杂 点 ， 首 先 判 断 是 否 播放 ， 如 果 未 播放 则 肯定 
是 第 一 次 播放 , 将 调用 playMusic 方法 进行 播放 , 把 播放 按钮 改 成 停止 图 片 , 状态 设置 为 true， 
也 就 是 播放 状态 。 如 果 已 经 播放 ， 又 分 暂停 中 和 没有 暂停 两 种 状态 ， 暂 停 时 就 继续 播放 ， 用 
handler 执行 一 个 Runnable， 里 面 是 死 循 环 ， 类 似 计时 器 ， 每 1 秒 钟 去 更 新 进度 条 。 没 有 暂停 
点 击 的 话 就 暂停 。 暂 停 播放 就 调用 handler 删除 Runnable。 

@ playMusic: 这 个 方法 用 来 播放 音乐 ， 只 有 第 一 次 点 击 播放 按钮 的 时 候 才 会 调用 ， 首 先 初始 化 
MediaPlayer， 设 置 播放 资源 (已 经 复制 了 一 个 chengdu.mp3 文件 放 到 了 res/raw 文件 夹 中 )， 
设置 播放 类 型 ， 设 置 播放 完成 监听 ， 预 加 载 完成 监听 ， 最 后 调用 prepare 方法 去 预 加 载 。 在 预 
加 载 完成 监听 回调 方法 中 , 设置 seekbar 的 总 进度 条 , 调用 mediaPlayer 的 start 方法 开始 播放 ， 
用 ghandler 启动 计时 器 来 设置 总 时 间 ， 将 时 间 蕉 转 成 分 秒 显示 。 
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@”onSeekBarChangeListener: 在 进度 条 结束 拖 动 方法 onStopTrackingTouch 中 设置 当前 播放 进度 ， 
告诉 mediaPlayer 跳 转 到 用 户 想 播放 的 位 置 。 

e ”onCompletionListener: 播放 完成 回调 ， 状 态 设置 成 暂停 状态 ， 播 放 图 片 显示 未 播放 图 片 ， 给 
mediaPlayer、seekBar、tvStartTime 设置 初始 值 ， 用 handler 终止 计时 器 。 
onDestroy: Activity 销毁 回调 ， 用 来 释放 mediaPlayer 资源 。 
getTimeStr: 给 一 个 时 间 蕉 返回 分 秒 格式 的 字符 囊 。 
mTicker: 类 似 计时 器 , 1 秒 钟 之 后 调用 自己 , 如 果 音频 在 播放 并 且 未 暂停 的 情况 下 更 新 seekbar 
的 播放 进度 ， 则 更 新 开始 时 间 。 


我 们 简单 地 实现 了 音乐 播放 、 拖 动 进 度 条 、 和 暂停 、 继 续 播放 。 其 实 播放 音频 的 代码 并 不 多 ， 
MediaPlayer 都 封装 好 了 ， 主 要 是 需要 自己 去 实现 这 个 逻辑 。 这 个 Demo 音频 播放 的 生命 周期 是 跟 
着 Activity 走 的 ， 但 是 市 面 上 的 App 都 可 以 在 后 台 播放 ， 就 算 用 户 关闭 了 软件 返回 到 手机 主 界面 ， 
音乐 还 在 播放 。 这 是 使 用 service 实现 的 ， 有 兴趣 的 读者 可 以 自己 去 实现 。 





7.2.2 播放 视频 的 三 种 方式 


在 Android 中 播放 视频 有 三 种 方式 ， 可 根据 自己 的 需求 去 选择 。 

1. 自 带 播放 器 

使 用 自 带 播放 器 播放 视频 比较 简单 ,使 用 隐 式 Intent 来 调用 它 , 通过 构造 方法 传 入 一 个 Action， 
调用 Intent 的 setDataAndType 方法 传 入 一 个 URL 与 视频 格式 。 


String path=Environment .getExternalStorageDirectory()+"/ansen.mp4"; 
Intent intent = new Intent (Intent.RCTION VIEW); 

intent .setDataAndType (Uri .parse ("file://"+path), "video/mp4"); 
startActivity (intent); 


2. 使 用 VideoView 方式 实现 
这 种 方式 不 怎么 灵活 ， 很 多 东西 不 可 控 。 


Uri uri = Uri.parse (Environment .getExternalStorageDirectory()+"/ansen.mp4"); 
VideoView videoView = (VideoView)this.findViewById(R.id.video view); 
videoView.setMediaController (new MediaController (this)); 
videoView.setVideoURI (uri); 

videoView.start (); 


3.MediaPlayer+TextureView 

如 果 想 显示 一 段 在 线 视频 或 者 任意 的 数据 流 ， 例 如 视频 或 者 OpenGL 场景 ， 可 以 使 用 Android 
中 的 TextureView 实现 。 

(1) TextureView 的 兄弟 SurfaceView 

应 用 程序 的 视频 或 者 OpenGL 内 容 往往 显示 在 一 个 特别 的 UI 控件 中 : SurfaceView。 
SurfaceView 的 工作 方式 是 创建 一 个 置 于 应 用 窗口 之 后 的 新 窗口 。 这 种 方式 的 效率 非常 高 ， 因 为 
SurfaceView 窗口 刷新 时 不 需要 重 绘 应 用 程序 的 窗口 (Android 普通 窗口 的 视图 绘制 机 制 是 一 层 一 
层 的 ,任何 一 个 子 元 素 或 者 局 部 的 刷新 都 会 导致 整个 视图 结构 全 部 重 绘 一 次 ， 因 此 效率 非常 低 ,不 
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过 满足 普通 应 用 界面 的 需求 还 是 绰绰有余 的 ) ， 当 然 ，SurfaceView 也 有 一 些 非常 不 便 的 限制 。 因 
为 SurfaceView 的 内 容 不 在 应 用 窗口 中 ， 所 以 不 能 使 用 变换 (平移 、 缩 放 、 旋 转 等 ) ， 也 难以 放 在 
ListView 或 者 ScrollView 中 ， 将 不 能 使 用 UI 控件 的 一 些 特性 ， 例 如 View.setAlpha()。 





( 2 ) TextureView 

为 了 解决 前 面 的 问题 ，Android 4.0 中 引入 了 TextureView。 与 SurfaceView 相 比 ，TextureView 
并 没有 创建 单独 的 Surface 来 绘制 ， 这 使 得 它 可 以 像 普 通 的 View 一 样 执行 一 些 变换 操作 ， 如 设置 
透明 度 等 。 另 外 ，TextureView 必须 在 硬件 加 速 开启 的 窗口 中 。 

在 项 目 中 ， 经 常会 碰 到 一 些 问题 ， 例 如 : 


@ 用 SurfaceView 播放 视频 时 ， 从 图 片 切换 到 播放 视频 会 出 现 黑屏 的 现象 。 
@ SurfaceView 灵活 性 没有 TextureView 好 。 


(3 ) 代码 是 最 好 的 老师 

首先 修改 布局 文件 activity_ main.xml， 最 外 层 是 一 个 LinearLayout， 里 面 有 一 个 FrameLayout 
与 SeekBar， 通 过 android:layout_weight 属性 来 控制 它们 的 高 度 。FrameLayout 中 有 TextureView 与 
ImageView 两 个 属性 ，TextureView 用 来 显示 视频 ，ImageView 用 来 显示 视频 的 第 一 帧 ， 也 就 是 视 
频 的 第 一 张 图 片 ， 只 有 在 视频 “播放 前 ”和 “播放 完成 后 ”两 个 状态 下 才 会 显示 。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match Parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<FrameLayout 
android:layout width="match parent" 
android:layout weight="30" 
android:layout height="0dp"> 


<TextureView 
android:id="@+id/textureview" 
android:layout width="match parent" 
android:layout height="match parent" /> 


<ImageView 
android:id="@+id/video image" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
android:src="@drawable/cover"/> 
</FrameLayout> 


<SeekBar 
android:id="@+id/seekbar" 
android:layout weight="1" 
android:layout width="match parent" 
android:layout height="0dp"/> 
</LinearLayout> 


布局 文件 对 应 的 MainActivity.java 实现 : 
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public class MainActivity extends Activity{ 
Private final String Tag = MainActivity.class.getSimpleName (); 


private MediaPlayer mMediaPlayer; 
private Surface surface; 


private ImageView videoImage; 
private SeekBar seekBar; 


Private Handler handler=new Handler(); 


Private final Runnable mTicker = new Runnable() { 
public void run() { 
long now = SystemClock.uptimeMillis(); 
long next = now + (1000 - now % 1000); 


handler .postAtTime (mTicker,next); 


// 延 迟 一 秒 再 次 执行 runnable， 与 计时 器 效果 一 样 


if (mMediaPlayer!=nullg&mMediaPlayer.isPlaying()){ 
seekBar .setProgress (mMediaPlayer .getCurrentPosition()); // 更 新 播放 进度 


@Override 

Protected void onCreate(Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 


TextureView textureView= (TextureView) findViewById(R.id.textureview); 
textureView.setSurfaceTextureListener (surfaceTextureListener); 


// 设 置 监听 函数 ， 重 写 4 个 方法 
videoImage=(ImageView) findViewById(R.id.video image); 


seekBar= (SeekBar) findViewById(R.id.seekbar); 
seekBar. setOnSeekBarChangeListener (onSeekBarChangeLi stener) ; //seekbar 改变 监听 


Private SurfaceTextureListener surfaceTextureListener=new 
SurfaceTextureListener() { 
//SurfaceTexture 可 用 
@Override 
Public void onSurfaceTextureAvailable(SurfaceTexture surfaceTexture, 
int width,int height) { 
surface=new Surface(surfaceTexture); 


new PlayerVideoThread() .start();// 开 启 一 个 线程 去 播放 视频 


handler .post (mTicker) ;// 更 新 进度 
} 


@Override 
Public void onSurfaceTextureSizeChanged (SurfaceTexture surface, int 
width,int height) {// 尺 寸 改变 
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} 


@Override 
public boolean onSurfaceTextureDestroyed (SurfaceTexture surfaceTexture) { 
// 销 毁 
surface=null; 
mMediaPlayer.stop(); 
mMediaPlayer.release(); 
mMediaPlayer=null; 
return true; 
} 


@Override 
Public void onSurfaceTextureUpdated (SurfaceTexture surfaceTexture) {// 更 新 
} 

Ts 


Private class PlayerVideoThread extends Thread{ 
@Override 
public void run(){ 
try { 
mMediaPlayer= new MediaPlayer (); 

Uri uri = Uri.parse("android.resource://com.example. 
textureviewvideo/"+R.raw.ansen); 
mMediaPlayer.setDataSource (MainActivity.this,uri); 

// 设 置 播放 资源 (可 以 是 应 用 的 资源 文件 /url / sdcard 路 径 ) 
mMediaPlayer.setSurface (surface) ;// 设 置 演 染 画板 
mMediaPlayer.setAudioSstreamType (AudioManager .STREAM MUSIC); 

// 设 置 播放 类 型 
mMediaPlayer.setOnCompletionListener (onCompletionListener); 

// 播 放 完成 监听 
mMediaPlayer.setOnPreparedListener (new OnPreparedListener() { 

@Override 

public void onPrepared (MediaPlayer mp) {// 预 加 载 完 成 
videoImage.setVisibility (View.GONE); 
mMediaPlayer.start () ;// 开 始 播放 


seekBar.setMax (mMediaPlayer.getDuration() );// 设 置 总 进度 
} 
$y 
mMediaPlayer .prepare(); 
} catch (Exception e) { 
e.printStackTrace (); 
} 


} 


private SeekBar.OnSeekBarChangeListener onSeekBarChangeListener=new 
SeekBar.OnSeekBarChangeListener() { 


@Override 
Public void onProgressChanged (SeekBar seekBar, int progress, boolean 


fromUser) {// 进 度 改 变 
} 


QOverride 
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public void onStartTrackingTouch (SeekBar seekBar) {// 开 始 拖 动 seekbar 
Log.i(Tag,"onStartTrackingTouch") 
} 


@Override 
public void onStopTrackingTouch (SeekBar seekBar) {// 停 止 拖 动 seekbar 
if (mMediaPlayer!=nullggmMediaPlayer.isPlaying()){ 
mMediaPlayer.seekTo (seekBar .getProgress ()); 
} 
} 
] 7 


Private MediaPlayer.OnCompletionListener onCompletionListener=new 


MediaPlayer.OnCompletionListener() { 


Goverride 
public void onCompletion (MediaPlayer mediaPlayer) {// 播 放 完成 
videoImage.setVisibility (View.VISIBLE); 
seekBar.setProgress (0); 
handler.removeCallbacks (mTicker); 
} 
3 


这 个 类 代码 有 点 多 ， 通 过 下 面 的 方法 进行 解析 : 


. 


onCreate: 首先 通过 findViewByld 查找 TextureView, 设置 SurfaceTexture 监听 , 查找 SeekBar， 
也 设置 了 SeekBar 改变 监听 。 

surfaceTextureListener: 重 写 了 四 个 方法 。 在 onSurfaceTextureAvailable 方法 中 开启 线程 去 播放 
视频 。 在 onSurfaceTextureDestroyed 方法 中 释放 surface 与 mMediaPlayer 对 象 。 
PlayerVideoThread: 播放 视频 多 线程 ， 查 看 run 方法 ， 新 建 一 个 MediaPlayer 对 象 ， 设 置 播放 
资源 、 设 置 泻 染 画 板 、 设 置 播放 类 型 、 设 置 播放 完成 监听 函数 、 设 置 预 加 载 ， 巴 加载 完 成 回 
调 方法 中 隐藏 图 片 ， 调 用 MediaPlayer 的 start 方法 开始 播放 。 将 视频 总 长 度 设置 为 seek 的 总 
进度 ， 通 过 handler 去 执行 Runnable 来 更 新 seekbar 的 进度 。 
onSeekBarChangeListener: seekbar 监听 ,在 onStopTrackingTouch 方法 中 判断 视频 有 没有 在 播 
放 ， 如 果 正 在 播放 中 ， 就 将 拖 动 的 进度 设置 为 MediaPlayer 当前 播放 的 进度 。 
onCompletionListener: 播放 完成 监听 ， 显 示 图 片 ，seekBar 进度 设置 为 0， 从 handler 中 删除 
Runnable， 终 止 计时 器 。 

mTicker: 每 秒 通 过 handler 调用 一 次 自己 达到 计时 器 的 效果 , 获取 当前 MediaPlayer 播放 进度 
来 更 新 进度 条 的 进度 。 


学 了 这 三 种 播放 视频 方式 应 该 能 够 解决 开发 中 的 大 部 分 需求 了 ， 但 是 实际 开发 中 会 有 很 多 新 
的 需求 ,如 全 屏 切换 、 和 暂停 、 继 续 播放 等 。 给 大 家 推荐 一 个 国内 很 好 的 视频 播放 开源 框架 (下载 地 
址 如 下 ) ， 这 个 框架 能 够 满足 90% 以 上 的 需求 。 


https://github.com/lipangit/JiaoZziVideoPlayer 
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7.3 ”调用 浏览 器 打开 网 页 


在 Android 中 可 以 调用 自 带 的 浏览 器 , 或 者 指定 一 个 浏览 器 来 打开 一 个 链接 ,只 需要 传 入 一 个 
URL《〈 可 以 是 链接 地 址 ) 即 可 。 


7.3.1 启动 Android 默认 浏览 


在 Android 中 ,可 以 通过 发 送 隐 式 Intent 来 启动 系统 默认 的 浏览 器 。 如 果 手 机 本 身 安装 了 多 个 
浏览 器 而 又 没有 设置 默认 浏览 器 的 话 ， 系 统 将 让 用 户 选择 使 用 哪个 浏览 器 来 打开 链接 。 
Uri uri = Uri.parse("https://www.baidu.com"); 


Intent intent = new Intent(Intent.ACTION VIEW, uri); 
startActivity (intent); 


使 用 以 上 三 行 代码 就 能 够 调用 系统 自 带 浏 览 器 。 


7.3.2 ”启动 指定 浏览 器 打开 


在 Android 中 , 可 以 通过 发 送 显 式 Intent 来 启动 指定 的 浏览 器 。 例如 , 手机 安装 了 多 个 浏览 器 ， 
包括 QQ 浏览 器 、Chrome 浏览 器 、UC 浏览 器 等 ， 可 以 指定 用 某 个 浏览 器 打开 这 个 链接 。 例 如 ， 
打开 QQ 浏览 器 ， 需 要 如 下 代码 : 

Uri uri = Uri.parse ("https://www.baidu.com"); 

Intent intent = new Intent(Intent.ACTION VIEW,uri); 

//intent .setClassName ("com.UCMobile", "com.uc.browser.InnerUCMobile");// 打 开 UC 浏 
览 器 

intent.setClassName ("com.tencent .mtt", "com.tencent.mtt.MainActivity");// 打 开 QQ 
浏览 器 

startActivity (intent); 

使 用 UC 浏览 器 打开 ， 只 需要 将 打开 QQ 浏览 器 那 行 代码 注释 掉 , 再 将 打开 UC 浏览 器 那 行 代 
码 取消 注释 即 可 。 


7.3.3 ”优先 使 用 


正常 情况 下 , 让 用 户 自 己 选择 使 用 QQ 浏览 器 打开 链接 .除非 有 特殊 需求 才 会 用 到 UC 浏览 器 。 

假如 你 想 用 UC 浏览 器 打开 , 但 是 新 版 本 的 UC 浏览 器 不 使 用 原来 的 包 名 了 ,这 时 就 没 法 打开 
了 。 另 外 , UC 浏览 器 兼容 可 能 存在 问题 , 跳 转 过 去 只 会 显示 UC 首页 , 而 不 是 直接 打开 提供 的 HTTP 
链接 。QQ 浏览 器 就 没有 这 个 问题 。 
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7.4 WebView 的 使 用 


WebView 在 Android 平台 上 是 一 个 特殊 的 View, 是 基于 Webkit 引擎 、 展 现 Web 页 面 的 控件 。 
这 个 类 可 以 在 App 中 显示 一 个 在 线 网 页 ， 还 可 以 用 来 开发 浏览 器 。WebView 内 部 实现 是 采用 泻 染 
引擎 来 展示 View 内 容 的 ， 提 供 网 页 的 前 进 与 后 退 、 网 页 放大 、 缩 小 、 搜 索 等 。Android 的 WebView 
在 低 版 本 和 高 版 本 采用 了 不 同 的 Webkit 版 本 内 核 ，4.4 版 本 后 直接 使 用 了 Chrome。 

现在 很 多 App 都 内 置 了 Web 网 页 ， 比 如 电 商 平台 (淘宝 、 京 东 、 聚 划算 等 ) 。WebView 比 
较 灵活 ， 不 需要 升级 客户 端 ， 只 需 修改 网 页 代码 即 可 。 一 些 经 常 变化 的 页 面 可 以 用 WebView 这 种 
方式 去 加 载 网 页 。 例 如 ， 中 秋 节 和 国庆 节 打 开 的 页 面 不 一 样 ， 如 果 是 用 WebView 显示 的 话 ， 只 需 
要 后 台 修 改 html 页 面 即 可 ， 而 不 需要 升级 客户 端 。 

WebView 功能 强大 , 可 以 直接 使 用 html 文件 (本 地 sdcard/assets 目录 ), 还 可 以 直接 加 载 URL， 
使 用 JavaScript 可 以 让 html 与 原生 App 互 调 。 

下 面 介绍 WebView 的 使 用 方法 。 


7.4.1 WebView 加 载 网 页 的 四 种 方式 


下 面 这 段 代码 介绍 WebView 加 载 网 页 的 四 种 方式 , 既 可 以 在 线 加 载 url, 也 能 加 载 本 地 的 html 
内 容 。 
webView.1loadUrl ("http://139.196.35.30:8080/0kHttpTest/apppackage/test.html"); 
// 加 载 url 
webView.loadUrl("file:///android asset/test.html") ;// 加 载 asset 文件 夹 下 的 html 


// 方 式 3: 加 载 手机 卡 上 的 html 页 面 


webView.loadUrl ("content://com.ansen.webview/sdcard/test.html"); 


// 方 式 4 使 用 webview 显示 html 代码 

webView.loadDataWithBaseURL (null, "<html><head><title> 欢迎 您 
</title></head>" + "<body><h2> 使 用 webview 显示 html 代码 </h2></body></html>"， 
"text/html" , "utf-8", null); 


7.4.2 WebViewClient 与 WebChromeClient 的 区 别 


Android WebView 作为 承载 网 页 的 载体 控件 ， 显 示 网 页 的 过 程 中 会 产生 一 些 事 件 ， 并 回调 给 
应 用 程序 , 以 便 我 们 在 网 页 加 载 过 程 中 做 应 用 程序 想 处 理 的 事情 。 比 如 说 客户 端 需 要 显示 网 页 加 载 
的 进度 、 网 页 加 载 发 生 的 错误 事件 等 。WebView 提供 两 个 事件 回调 类 给 应 用 层 ， 分 别 为 
WebViewClient、WebChromeClient， 开 发 者 可 以 继承 这 两 个 类 ， 接 手相 应 事件 处 理 。 

WebViewClient 主要 帮助 WebView 处 理 各 种 通知 、 请 求 事件 ， 有 以 下 几 个 常用 方法 。 
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onPageFinished: 页 面 请 求 完成 。 

onPageStarted: 页 面 开 始 加 载 。 

shouldOverrideUrlLoading: 拦截 url。 

onReceivedError: 访问 错误 时 回调 ， 例 如 访问 网 页 时 报错 404， 在 这 个 方法 回调 的 时 候 可 以 
加 载 错 误 页 面 。 


WebChromeClient 主要 辅助 WebView 处 理 Javascript 的 对 话 框 、 网 站 图 标 、 网 站 tile、 加 载 进 
度 等 ， 有 以 下 几 个 常用 方法 。 

@ onjJsAlert， WebView 不 支持 JS 的 alert 弹 窗 ， 需 要 自己 监听 后 通过 dialog 弹 窗 。 

e@ onReceivedTitle: 获取 网 页 标题 。 

@ ”onReceivedIcon: 获取 网 页 icon。 

@ ”onProgressChanged: 加 载 进度 回调 。 


7.4.3 ”WebView 的 简单 使 用 


前 面 讲 解 了 加 载 html 的 四 种 方式 ， 以 及 WebViewClient 与 WebChromeClient 的 区 别 ， 接 下 来 
通过 代码 来 实践 。 
新 建 项 目 ， 修 改 首页 布局 文件 activity_main.xml: 


<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<WebView 
android:id="@+id/webview" 
android:layout width="match parent" 
android:layout height="match parent"/> 


<ProgressBar 

android:id="@+id/progressbar" 
style="@android:style/Widget.ProgressBar.Horizontal" 
android:layout width="match parent" 
android:layout height="3dip" 
android:max="100" 
android:progress="0" 
android:visibility="gone"/> 

</FrameLayout> 


外 层 为 FrameLayout, 里 面 有 WebView 与 ProgressBar。 WebView 的 宽 高 匹配 父 类 , ProgressBar 
横向 进度 条 ， 高 度 3dip， 按 照 FrameLayout 布局 规则 ，ProgressBar 会 覆盖 在 WebView 之 上 ， 默 认 
是 隐藏 不 显示 。 

因为 需要 加 载 网 页 URL， 所 以 需要 在 AndroidManifest.xml 中 添加 访问 网 络 权限 。 


<uses-permission android:name="android.permission.INTERNET" /> 
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布局 文件 对 应 的 MainActivityjava 内 容 如 下 : 


Public class MainActivity extends AppCompatActivity { 
private WebView webView; 
Private ProgressBar progressBar; 


Q@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


progressBar= (ProgressBar)findViewById(R.id.progressbar); // 进 度 条 


webView = (WebView) findViewById(R.id.webview); 
// webView.loadUrl ("file:///android asset/test.html"); 
// 加 载 asset 文件 夹 下 的 html 


webView.loadUrl ("http://139.196.35.30:8080/0kHttpTest/apppackage/ 


test.html");// 加 载 url 


// 使 用 webview 显示 html 代码 
//webView.loadDataWithBaseURL (null, "<html><head><title> 欢迎 您 


//</title></head>" +"<body><h2> 使 用 webview 显示 html 人 局 9</h2></body></html>"， 


//"text/html" , "utf-8", null); 


webView.addJavascriptInterface (this,"android"); 
// 添 加 js 监听 ， 这 样 html 就 能 调用 客户 端 

webView.setWebChromeClient (webChromeClient); 

webView.setWebViewClient (webViewClient); 


WebSettings webSettings=webView.getSettings(); 
websettings.setJavaScriptEnabled (true) ;// 人 允许 使 用 js 


xx 

* LORD CACHE ONLY: 不 使 用 网 络 ， 只 读 取 本 地 缓存 数据 。 

* LOAD DEFAULT: (默认 ) 根据 cache-control 决定 是 否 从 网 络 上 取 数 据 。 

* LOAD NO CACHE: 不 使 用 缓存 ， 只 从 网 络 获取 数据 。 

* LOAD CACHE ELSE NETWORK， 只 要 本 地 有 ， 无 论 是 否 过 期 ， 或 者 no-cache， 
都 使 用 缓存 中 的 数据 。 

入 

webSettings.setCacheMode (WebSettings.LOAD NO CACHE); 
// 不 使 用 缓存 ， 只 从 网 络 获取 数据 。 


// 支 持 屏幕 缩放 
webSettings .setSupPort2Zoom (上 true) 
webSettings.setBuiltIinZoomControls (true); 


// 不 显示 webview 缩放 按钮 
// webSettings.setDisplayZoomControls (false); 
} 


//WebViewClient 主要 帮助 WebView 处 理 各 种 通知 、 请 求 事件 
Private WebViewClient webViewClient=new WebViewClient ()1{ 
@Override 


public void onPageFinished (WebView view，String url) {// 页 面 加 载 完成 


progressBar.setVisibility (View.GONE); 
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} 


@Override 
public void onPageStarted (WebView view, String url, Bitmap favicon) { 
// 页 面 开始 加 载 
progressBar.setVisibility (View.VISIBLE); 
} 


@Override 
public boolean shouldOverrideUrlLoading (WebView view, String url) { 
Log.i("ansen", "拦截 url:"+turl); 
if(url.equals ("http://www.google.com/")){ 
Toast.makeText (MainActivity.this," 国内 不 能 访问 google, 拦截 该 url"， 
Toast .LENGTH LONG) .show(); 
return true;// 表 示 我 已 经 处 理 过 了 
} 


return super.shouldOverrideUrlLoading (view, url); 


] 7 


//WebChromeClient 主要 辅助 WebView 处 理 Javascript 的 对 话 框 、 网 站 图 标 、 网 站 title、 
// 加 载 进度 等 
Private WebChromeClient webChromeClient=new WebChromeClient (){ 
// 不 支持 js 的 alert 弹 窗 ， 需 要 自己 监听 ， 然 后 通过 dialog 弹 窗 
@Override 
Public boolean onJsAlert (WebView webView, String url, String message, 
JsResult result) { 
AlertDialog.Builder localBuilder = new AlertDialog.Builder 
(webView.getContext ()); 
localBuilder.setMessage (message) .setPositiveButton ("确定 ", nul11); 
localBuilder.setCancelable (false); 
localBuilder.create() .show(); 


// 注 意 : 

// 必 须要 有 result .confirm()， 

// 表 示 处 理 结果 为 确定 状态 同时 唤醒 Webcore 线程 
// 和 否则 不 能 继续 点 击 按钮 

result .confirm(); 

return true; 


} 
// 获 取 网 页 标题 


@Override 

Public void onReceivedTitle (WebView view, String title) { 
super.onReceivedTitle(view, title); 
Log.i("ansen", "网 页 标题 :"+title); 

} 


// 加 载 进度 回调 

@Override 

Public void onProgressChanged (WebView view, int newProgress) { 
progressBar.setProgress (newProgress); 


E 
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GOverride 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 
Log.i("ansen", "是 否 有 上 一 个 页 面 :"+webView.canGoBack ()); 
if (webView.canGoBack() && keyCode == KeyEvent .KEYCODE BACK){ 
// 点 击 返 回 按钮 的 时 候 判 断 有 没有 上 一 页 
webView.goBack() ; // goBack() 表 示 返 回 WebView 的 上 一 页 面 
return true; 


有 
return super.onKeyDown (keyCode,event); 


} 


/x 

* JS 调用 Android 的 方法 

* @param St 

* @return 

本 

@JavascriptInterface // 仍 然 必 不 可 少 

public void getClient (String str){ 
Log.i("ansen", "html 调用 客户 端 :"+str); 

} 


@Override 
protected void onDestroy() { 
super.onDestroy(); 


// 释 放 资 源 
webView.destroy(); 
webView=null; 


onCreate: 查找 控件 ， 给 WebView 设置 加 载 url， 添 加 JS 监听， 监听 的 名 称 是 "android"， 设 
置 webChromeClient 与 webViewClient 回调 ， 通 过 getSettings 方法 获取 WebSettings 对 象 ， 设 
置 允许 加 载 JS， 设 置 缓存 模式 ， 支 持 缩放 。 

webViewClient: 重 写 了 几 个 方法 ，onPageFinished 页 面 加 载 完成 隐藏 进度 条 ，onPageStarted 
页 面 开始 加 载 显 示 进 度 条 ，shouldOverrideUrlLoading 拦 蕉 url， 如 果 请 求 url 是 打开 Google， 
则 不 让 它 请 求 ， 因 为 Google 在 国内 不 能 访问 ， 还 不 如 拦截 掉 ， 直 接 告 诉 用 户 不 能 访问 。 
webChromeClient: WebView 不 支持 alert 弹 窗 ， 在 这 个 方法 中 用 AlertDialog 去 弹 窗 。 
onReceivedTitle 获取 网 页 标题 . onProgressChanged 页 面 加载 进 度 , 将 加 载 进度 给 progressBar。 
onKeyDown: 如 果 点 击 系统 自 带 返回 键 并 且 WebView 有 上 一 个 页 面 ， 则 调用 goBack 返回 上 一 页 
内 容 ; 否则 我 们 不 处 理 ， 交 给 父 类 的 onKeyDown 方法 处 理 。 什 么 时 候 会 有 上 一 级 页 面 呢 ? 就 是 从 
首页 跳 转 到 一 个 新 页 面 ， 点 击 返回 时 会 返回 首页 。 如 果 本 来 就 位 于 首页 ， 点 击 返 回 时 会 退出 App。 
getClient: html 页 面 的 JS 可 以 通过 这 个 方法 回调 原生 App。 这 个 方法 有 个 注解 
@JavascriptInterface， 这 是 必须 的 。 这 个 方法 有 一 个 字符 串 参 数 ， 这 个 方法 与 在 onCreate 中 
调用 addJavascriptInterface 传 入 的 name 一 起 使 用 。 例 如 ，html 中 想 要 回调 这 个 方法 ， 可 以 写 
成 javascript:android.getClient (" 传 一 个 字符 囊 给 客户 端 " )。 

onDestroy: Activity 销毁 时 释放 WebView 资源 。 
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运行 代码 ， 效 果 如 图 7-5 所 示 。 


两 调用 育 户 滑 








7-5 Webview 的 简单 使 用 效果 


7.5 “复制 和 粘贴 


Android 提供 的 剪贴 板 框架 ， 允 许 复 制 和 粘贴 不 同类 型 的 数据 。 数 据 可 以 是 文本 、 图 像 、 二 进 
制 流 数据 或 其 他 复杂 的 数据 类 型 。 另 外 ， 还 可 以 复制 多 条 记录 ， 其 功能 很 强大 。 当 然 ， 大 部 分 用 户 
只 需要 复制 文本 ， 下 面 学 习 文本 的 复制 。 


7.5.1 复制 文本 


String text = "abcdefg"; 
ClipboardManager cmb = (ClipboardManager) 
getSystemService (Context .CLIPBOARD SERVICE); 
cmb.setPrimaryClip(ClipData.newPlainText (null,text)); 
首先 获取 ClipboardManager 对 象 ， 全 包 名 是 android.content.ClipboardManager， 调 用 
setPrimaryClip 给 剪贴 板 赋 值 。 


7.5.2 ”粘贴 文本 


ClipboardManager clipboardManager = (ClipboardManager) 
getSystemService (Context .CLIPBOARD SERVICE); 

String content= clipboardManager.getText() .toString(); 

Log.i("ansen","content:"+content); 


首先 获取 ClipboardManager 对 象 ， 然 后 调用 getText 获取 文本 信息 。 


7.6 ”定位 的 使 用 


在 Android 开发 中 地 图 跟 定位 是 很 多 App《〈 应 用 程序 ) 不 可 缺少 的 内 容 , 这 些 特色 功能 给 人 们 
带 来 了 很 多 方便 。 
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7.6.1 定位 的 三 种 方式 


在 Android 系统 中 定位 有 三 种 方式 : GPS 定位 、WiFi 定位 、 基 站 定位 。 
1. GPS 定位 


GPS (Global Positioning System， 全 球 定位 系统 ) 是 由 美国 建立 的 一 个 卫星 导航 定位 系统 。 利 
用 该 系统 ,用 户 可 以 在 全 球 范围 内 实现 全 天 候 、 连 续 、 实 时 的 三 维 导 航 定位 和 测速 ; 另外 ， 用 户 还 
能 够 进行 高 精度 的 时 间 传递 和 高 精度 的 精密 定位 。 

使 用 GPS 定位 ， 需 要 硬件 支持 ， 基 本 上 每 部 Android 手机 都 支持 GPS 定位 。 直 接 和 卫星 交互 
来 获取 当前 经 纬度 。 

使 用 GPS 的 优点 如 下 : 

e 速度 快 。 

。 精度 高 。 

”可 在 无 网 络 情况 下 使 用 。 

使 用 GPS 的 缺点 如 下 : 
首次 连接 时 间 长 。 

只 能 在 户外 开阔 地 使 用 ， 设 备 不 能 被 遮挡 。 在 室内 基本 不 能 使 用 。 

@ 比较 耗 电 。 

2. WiFi 定位 

WiFi 定位 是 根据 一 个 固定 的 WiFi MAC 地 址 ， 通 过 收集 到 的 该 WiFi 热点 的 位 置 ， 然 后 访问 
网 络 上 的 定位 服务 以 获得 经 纬度 坐标 。 它 和 基站 定位 其 实 都 需要 使 用 网 络 ， 所 以 在 Android 也 统称 
为 Network 方式 。 

使 用 WiFi 定位 的 优点 在 于 受 环 境 影 响 较 小 ， 只 要 有 WiFi 的 地 方 即 可 使 用 。 

使 用 WiFi 定位 的 缺点 是 需要 有 WiFi、 精 度 不 准 ， 并 且 需 要 请 求 第 三 方 API。 

3. 基站 定位 

基站 定位 的 方式 有 多 种 ， 一 般 手 机 附近 的 三 个 基站 进行 三 角 定 位 ， 由 于 每 个 基站 的 位 置 是 固 
定 的 ， 利 用 电磁 波 在 这 三 个 基站 间 中 转 需 要 时 间 来 算出 手机 所 在 的 坐标 。 

还 有 一 种 方式 是 获取 最 近 的 基站 信息 ， 其 中 包括 基站 ID、Location Area Code、Mobile Country 
Code、Mobile Network Code 和 信号 强度 ， 将 这 些 数 据 发 送 到 Google 的 定位 Web 服务 中 ， 就 能 获 
取 当 前 所 在 的 位 置信 息 。 

使 用 基站 定位 的 优点 是 : 

@” 受 环境 的 影响 情况 较 小 ， 只 要 有 基站 的 地 方 都 能 使 用 。 一 般 的 地 方 都 有 有， 除非 那 种 鸟 无 人 烟 

的 地 方 ， 毕 竟 基 站 运营 商 也 是 需要 考虑 成 本 的 。 


使 用 基站 定位 的 缺点 是 : 
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需要 消耗 流量 。 

精度 没有 GPS 那么 准确 ， 大 概 在 十 几米 到 几 十 米 之 间 。 

需要 根据 基站 信息 请 求 API 接口 获取 位 置 ,Google 公开 的 API 在 国内 没 法 访问 。 移 动 与 联通 
有 公开 基础 基站 信息 获取 位 置 的 API。 


7.6.2 ”定位 的 相关 类 

1. LocationManager 

LocationManager 为 位 置 服务 管理 器 类 ， 无 论 采 用 哪 种 方式 获取 位 置信 息 ， 都 需要 获取 一 个 
LocationManger 对 象 。 


LocationManager locationManager = (LocationManager) getSystemService (Context. 
LOCATION_ SERVICE); 


LocationManager 对 象 有 四 个 常量 ， 用 来 区 分 定位 方式 。 
NETWORK PROVIDER: 网 络 定 位 。 
GPS_PROVIDER: 通过 GPS 定位 。 
PASSIVE_PROVIDER: 被 动 地 获取 定位 信息 ， 通 过 接受 其 他 App 或 Service 的 定位 信息 。 
FUSED_PROVIDER: Google 已 经 将 这 个 定位 方式 隐藏 了 。 
. Location 位 置 对 象 
描述 地 理 位 置信 息 的 类 ， 记 录 了 经 纬度 、 海 拔高 度 、 获 取 坐 标 时 间 、 速 度 、 方 位 等 。 可 以 通 
过 LocationManager.getLastKnowLocation(provider) 获 取 位 置 坐标 ，provider 就 是 定位 方式 ， 也 是 上 
文中 提 到 的 LocationManager 的 四 个 常量 之 一 。 
大 部 分 情况 下 ， 通 过 getLastKnowLocation 得 到 的 Location 对 象 都 为 null， 实时 动态 坐标 可 以 
在 监听 器 locationListener 的 onLocationChanged(Location location) 方 法 中 来 获取 。 
3. LocationListener 位 置 监听 接口 
LocationListener 用 于 监听 位 置 (包括 GPS、 网 络 、 基 站 等 所 有 提供 位 置 的 ) 变化 ， 监 听 设 备 
开关 与 状态 ， 实 时 动态 获取 位 置信 息 。 
(1) 注册 监听 : LocationManger.requestLocationUpdates(String provider, long minTime，float 


© © © 9 


DD 


minDistance, LocationListener listener)。 
(2) 使 用 完 之 后 ， 需 要 在 适当 的 位 置 移 除 监听 (不 需要 获取 位 置信 息 或 者 程序 退出 时 ): 
Location Manager .removeUpdates(LocationListener listener)。 
实现 LocationListener 接口 需要 重 写 以 下 几 个 方法 : 
® onLocationChanged(Location location): 当 位 置 发 生变 化 时 会 自动 调用 该 方法 ， 参 数 location 
记录 了 最 新 的 位 置信 息 。 
® onStatusChanged(String provider, int status, Bundle extras): 当 位 置 提供 者 的 状态 发 生 改 变 (可 
用 到 不 可 用 、 不 可 用 到 可 用 ) 时 自动 调用 该 方法 。 
onProviderEnabled(String provider): 位 置信 息 提供 者 可 用 时 自动 调用 ， 例 如 GPS 开启 。 
onProviderDisabled(String provider): 位 置信 息 不 可 用 时 自动 调用 ， 例 如 禁用 GPS 。 
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7.6.3 GPS 获取 经 纬度 


前 面 讲述 了 定位 的 三 种 方式 , 基站 定位 和 WiFi 定位 都 需 
调用 第 三 方 API 接口 获取 位 置信 息 ， 因 此 本 节 内 容 主要 讲述 如 
何 使 用 GPS 实现 定位 。 

1. 手机 打开 GPS 定位 

首先 进入 系统 设置 界面 一 服务 与 偏好 设置 一 位 置信 息 一 开 
启 GPS。 设 置 界面 开启 GPS 可 能 会 因为 手机 厂商 不 一 致 ， 导 致 
开启 GPS 的 界面 略 有 区 别 。 本 书 截 图 的 这 款 手机 是 Google 和 
HTC 合作 的 Pixel 手机 ，Android 8.0 原生 操作 系统 。 





效果 图 如 图 7-6 所 示 。 

从 图 7-6 中 可 以 看 到 ，GPS 已 经 处 于 打开 状态 。 

2. 源码 实现 

新 建 项 目 ， 因 为 需要 使 用 GPS 定位 ， 所 以 首先 在 


AndroidManifest.xml 中 加 入 权限 。 


<uses-permission 
android:name="android.permission. 
ACCESS_FINE LOCATION" /> 


修改 首页 布局 文件 activity_main.xml, 布局 文件 很 简单 , 仅 
-个 TextView， 用 来 显示 经 纬度 信息 。 


<?xml version="1.0" encoding="utf-8"?> 


包括 
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图 7-6 打开 手机 的 GPS 功能 


<LinearLayout xmlns:android="http://schemas .android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent" 
android:padding="10dp"> 


<TextView 
android:id="@+id/tv location" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Hello World!"/> 
</LinearLayout> 


首页 布局 文件 对 应 的 MainActivity.java 内 容 如 下 : 


Public class MainActivity extends AppCompatActivity { 


Private LocationManager locationManager; 
Private TextView tvLocation; 


QOverride 


Protected void onCreate (Bundle savedInstanceState) { 


Super .onCreate (savedInstanceState) 
setContentView(R.layout .activity main); 
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tvLocation= (TextView) findViewById(R.id.tv location) 


locationManager = (LocationManager) getSystemService 
(Context.LOCATION SERVICE); 
startRequestLocation(); 
| 


Private void startRequestLocation(){ 
boolean gps = locationManager.isProviderEnabled(LocationManager. 
GPS PROVIDER) 7 
if(!gps){ 
Toast .makeText (this, "请 先 设置 界面 开启 GPS 定位 服务 ", Toast .IENGTH LONG) .show(); 
return 7 


I. 


Location location=locationManager.getLastKnownLocation (LocationManager. 
GPS PROVIDER) ; // 通 过 GPS 获取 位 置 
if (location != null) { 
ShowLocation (Location) 7 


} 


/** 

* 监听 位 置 变 化 

* 参数 1， 定 位 方式 ， 主 要 有 GPS_PROVIDER 和 NETWORK_PROVIDER， 前 者 是 GPS, 后 者 
是 GPRS 以 及 WIFI 定位 

* 参数 2， 位 置信 息 更 新 周期 ， 单 位 是 毫秒 

而 2 3， 位 置 变化 最 小 距离 。 当 位 置 距离 变化 超过 此 值 时 ， 将 更 新 位 置信 息 

* 参数 4， 监 听 

* 备注 : 参数 2 和 3， 如 果 参 数 3 不 为 0， 则 以 参数 3 为 准 ; 参数 3 为 0， 则 通过 时 间 来 定 
时 更 新 ;两 者 为 0， 则 随时 刷新 

过 

locationManager.requestLocationUpdates (LocationManager .GPS PROVIDER, 

1000, 10,1locationListener); 

E 


private LocationListener locationListener=new LocationListener() { 
@Override 
Public void onLocationChanged (Location location) { 
showLocation (location); 
和 


// 当 位 置 提供 者 的 状态 发 生 改 变 


@Override 
Public void onStatusChanged (String provider, int status, Bundle extras) {} 


// 位 置信 息 提供 者 可 用 时 自动 调用 ， 例 如 GPS 开启 
@Override 
Public void onProviderEnabled(String provider) { 


上 

// 位 置信 息 不 可 用 时 自动 调用 ， 例 如 禁用 GPS 

@Override 

Public void onProviderDisabled(String provider) { 
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/六 
* 显示 定位 结果 
* @param Location 
本 
Private void showLocation (Location location){ 
if(location!=nul1){ 
tvLocation.setText ("经 度 : "+location.getLongitude () +"\n"+" 纬 度 : 
"+location.getLatitude()); 
} 
} 


@Override 
protected void onDestroy() { 
super.onDestroy(); 
locationManager .removeUpdates (locationListener); 


e@ ”onCreate: 查找 TextView， 获 取 LocationManager 对 象 ， 然 后 调用 startRequestLocation 方法 请 

@ startRequestLocation: 首先 判断 GPS 是 否 开启 ， 若 没有 开启 则 不 进行 定位 。 通 过 
getLastKnownLocation 方法 获取 最 后 位 置信 息 ,第 一 次 定位 时 ， 这 个 方法 肯定 会 返回 null, 最 
后 调用 requestLocationUpdates 方法 开启 定位 监听 变化 。 通过 第 二 个 与 第 三 个 参数 来 决定 回调 
locationListener: 在 onLocationChanged 方法 中 调用 showLocation 更 新 位 置信 息 。 
showLocation: 将 当前 的 经 纬度 信息 显示 到 TextView 上 。 
onDestroy: Activity 退出 移 除 定位 监听 。 


OnAT 8:48PM 


运行 程序 ， 其 效果 图 如 图 7-7 所 示 。 LocationTest 
注意 事项 : 
需要 先 设置 界面 开启 GPS， 再 打开 软件 。 
因为 是 GPS 定位 ， 需 要 到 室外 ， 有 时 手机 拿 出 窗外 就 能 
定位 ， 主 要 看 卫星 情况 。 
@ 第 一 次 定位 需要 时 间 ， 可 以 多 等 一 会 。 如 果 超 过 5 分 钟 还 没有 获取 到 位 置信 息 ， 就 检查 前 面 
两 条 注意 事项 。 





图 7-7 显示 经 纬度 


7.6.4 根据 经 纬度 反 向 编码 获取 地 址 


当 我 们 拿 到 一 个 经 纬度 时 ， 得 到 的 是 两 个 Double 类 型 的 值 ， 是 一 个 空间 坐标 地 址 ， 这 时 需要 
转换 成 看 得 懂 的 值 ， 就 需要 地 理 反 编码 (Reverse Geocoding) 。 

同 理 ， 如 果 知 道 当 前 所 在 的 街道 具体 地 址 ， 然 后 想 拿 到 空间 坐标 地 址 ， 就 是 经 纬度 ， 需 要 地 
理 编码 (Geocoding) 。 
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1. 反 编 码 相 关 类 


(1) Geocoder 

该 类 用 于 地 理 编码 与 反 向 编码 。 

Geocoder 请 求 的 是 一 个 后 台 服 务 , 但 是 该 服务 不 包括 在 标准 Android Framework 中 。 因此， 如 
果 当 前 设备 不 包含 Location Services， 则 Geocoder 返回 的 地 址 或 者 经 纬度 为 空 。 

当然 , 可 以 使 用 Geocoder.isPresent() 方 法 来 判断 当前 设备 是 否 包含 地 理 位 置 服务 。 由 于 国内 使 
用 不 了 Google Services 服务 ， 因 此 一 般 的 手机 厂商 都 会 在 自己 的 手机 内 管 百度 地 图 服务 或 者 高 德 
地 图 服务 来 替代 Google Services 服务 。 

创建 Geocoder 对 象 有 两 个 构造 方法 。 


®@ new Geocoder(Context context, Locale locale): 参数 1 是 context， 参 数 2 是 国家 /地 区 代码 。 

@ new Geocoder(Context context): 参数 1 是 context， 因 为 没有 指定 国家 /地 区 代码 ， 初 始 化 时 会 
取 系 统 设置 的 国家 /地 区 代码 。 

这 个 对 象 有 两 个 常用 方法 : 

® getFromLocation(double latitude, double longitude, int maxResults): 根据 经 纬度 获取 地 址 ， 其 中 
参数 latitude 获取 纬度 ，longitude 获取 经 度 ，maxResults 返回 地 址 的 数目 ( 由 于 同一 经 纬度 可 
能 对 应 多 个 地 址 ， 该 参数 取 1~5 )。 

® getFromLocationName(String locationName, int maxResults): 根据 地 址 获取 经 纬度 信息 ， 其 中 
参数 locationName 用 于 获取 地 址 信息 (例如 ， 上 海 市 闵行 区 xx 路 112 号 )，maxResults 用 于 
返回 条 数 (由 于 同一 地 址 可 能 对 应 多 个 经 纬度 ， 该 参数 取 1~5 )。 


(2 ) Address 
-个 地 理 位 置信 息 ， 其 中 Address 类 中 包含 了 各 种 地 理 位 置信 息 ， 包 括 经 纬度 、 国 家 /地 区 、 

城市 、 地 区 、 街 道 、 国 家 /地 区 编码 、 城 市 编码 等 。 
getCountryName: 国家 /地 区 名 称 。 
getCountryCode: 国家 /地 区 编码 。 
getAdminArea: 省 份 。 
getLocality: 市 。 
getFeatureName: 道路 。 
getLatitude: 纬度 。 
getLongitude: 经 度 。 





我 们 在 上 一 节 的 项 目 代码 上 进行 修改 ， 首 先 修改 activity_main.xml 文件 ， 添 加 一 个 TextView， 
用 来 显示 反 向 编码 后 的 地 址 。 
接 下 来 修改 MainActivity.showLocation 方法 ， 将 获取 的 经 纬度 反 向 编码 为 地 址 ， 将 国家 /地 
名 称 与 城市 显示 到 TextView 上 : 
Private void showLocation (Location location){ 
if(location!=null1){ 


tvLocation.setText ("经 度 : "+location.getLongitude ()+"\n"+" 纬 度 : " 
+location.getLatitugde()); 





[El 
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} 


Geocoder geocoder = new Geocoder (this,Locale.CHINA); 
中 


i 
/ /参数 1 :纬度 参数 2: 经 度 参数 3: 返 回 地 址 的 数目 (由 于 同一 经 纬度 可 能 对 应 多 个 地 
址 ， 该 参数 取 1~5) 


List<Address> addressList = geocoder.getFromLocation (location. 
getLatitude(),location.getLongitude(),1); 
for (Address address : addressList) { 


tvAddress.setText (address.getCountryName ()+" 
"+address.getLocality()); 


Log.i("ansen", address.toString()); 
} catch (IOException e) { 
e.printStackTrace (); 
} 
} 
修改 后 运行 代码 ， 效 果 如 图 7-8 所 示 。 


(2 11:31AM 


[olets\d[ol ES 


121.3899043 
31.10837706 





图 7-8 ”根据 经 纬度 反 向 编码 获取 地 址 
从 图 7-8 中 可 以 看 到 显示 了 所 在 的 国家 /地 区 和 城市 名 。 当 然 ， 还 可 以 调用 Address 的 
getFeatureName 方法 将 街道 地 址 显示 出 来 。 


经 过 测试 ， 发 现在 国内 买 的 锤子 手机 能 根据 经 纬度 反 向 编码 出 地 址 ， 但 是 从 国外 买 的 Pixel 
(Google 与 HTC 合作 ) 手机 无 法 反 编码 出 地 址 。 








7.7 NDK 与 JNI 开 发 


本 节 学 习 如 何在 Android 中 使 用 C++ 开发 。 
7.7.1 什么 是 NDK 


NDK (Native Development Kit) 提供 了 一 系列 的 工具 集合 ， 帮 助 开发 者 快速 开发 C (或 C++) 
的 动态 库 ， 并 且 能 够 自动 将 So 和 Java 应 用 一 起 打包 成 APK。NDK 集成 了 交叉 编译 器 ,可 以 针对 
不 同 的 CPU 编译 不 同 的 so 文件 。 

使 用 NDK 的 优点 如 下 : 
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运行 效率 高 (C/C++ 的 运行 速度 高 于 Java )。 

代码 安全 性 高 (Java 是 半 解 释 型 语言 ， 容 易 被 别人 反 编 译 代码 )。 

代码 复 用 与 移植 (用 C++ 开发 的 代码 ， 不 仅 可 以 在 Android 中 使 用 ， 还 可 以 嵌入 其 他 平台 ， 
例如 iOS )。 


7.7.2 NDK 下 载 


在 Android Studio 中 下 载 NDK 很 简单 ， 有 具体 步骤 如 下 : 
步 又 014 点 击 标题 栏 File>Project Structure， 如 图 7-9 所 示 。 






DOpen.. -P+ 交心 书 国 时 


Open Recent > 
Ce Close Project 
makect 加 让 和 yn 
en Doc Link C++ Project win Grade 下 
.gradle I 
Didea - 2 
s de "me: 
8 bold | mport Setings. ” 国 
昌 hbs | Eport Setings Bm 
忆 v Osre Settings Repository.. 7 
androl 
昌 w Omain| HSaveAll %S 时 
和 vw Ojavi ® Synchronize - 
§ Y 四 | Invalidate Caches / Restart... 
由 


Export to HTML.. 


* gr ge 本 ; 
> Dtest Addto Favorites » 
日 gmignore 
Dappjml | Line Separators 


buld, gra Make Directory Read-only 
proguard” Power Save Mode 


图 7-9 点击 Project Structure 
步骤 024 进入 如 图 7-10 所 示 的 Project Structure 对 话 框 ， 如 果 还 未 下 载 过 NDK， 则 NDK 路 
径 输入 框 中 什么 都 没有 ， 点 击 Download 链接 进行 下 载 。 


Pei Suvcture 





So teaaten 


Ne nen the he parol Sor ocated, Ts locsoon ol be used for new projects, 
nd for exlsting projects hat le with 2 sdk de property, 


[osers/ansenf Ubrary/Android /sdk 





Jok locatione 
The dyectory where the Java Development nt gON is located 


© Use embedded JOK (recommended) 
/Applications Aneiroid Srudhio app/Contenis /jre/Jdk /Conienits fHiome 


Androld NDK 
Me een me oe oro ors Jocated. Ts location wal be saved as nair 
properny In dhe local properties, 





Download Anerold NOK 











~ ED 
图 7-10 ”Project Structure 对 话 框 


步骤 034 下 载 过 程 会 有 点 慢 , 大 家 耐心 等 待 。 下 载 完成 之 后 ,点 击 Finish 按钮 就 可 以 看 到 NDK 
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在 本 地 的 磁盘 路 径 地 址 了 。 


7.7.3 在 Mac 下 加 入 NDK 环境 变量 


步骤 01 打开 Terminal 终端 命令 窗口 ， 使 用 命令 切换 到 home 目录 下 : 


























Sass 
步 又 024 使 用 touch 命令 。 这 个 命令 有 两 个 功能 : 


@ ”如 果 文 件 存在 ， 就 将 已 存在 文件 的 时 间 标 签 更 新 为 系统 当前 时 间 。 
日 ”如 果 文 件 不 存在 ， 就 创建 新 的 空 文件 。 




















touch .bash profile 
步骤 034 使 用 如 下 命令 打开 文件 : 
open -e .bash profile 
步骤 044 添加 环境 变量 。 在 打开 的 文件 最 后 增加 如 下 两 行 代码 保存 文件 。 其 中 , NDK_ROOT 
指向 的 路 径 需要 替换 为 自己 的 NDK 路 径 。 这 个 路 径 在 下 载 NDK 的 页 面 中 就 能 够 复制 。 


export NDK ROOT=/Users/ansen/Library/Android/sdk/ndk-bundle 
export PATH=${PATH}:${NDK ROOT} 


步骤 054 使 用 修改 后 的 文件 : 

source .bash profile 

步骤 064 验证 NDK 环境 变量 是 否 配置 成 功 。 在 终端 中 输入 “ndk-build" ， 如 果 显示 下 面 类 似 
的 内 容 就 表示 成 功 了 : 


Android NDK: Could not find application project directory ! 

Android NDK: Please define the NDK PROJECT PATH variable to point to it. 

/Users/ansen/Library/Android/sdk/ndk-bundle/build/core/build-local.mk:151: 
*** Android NDK: Aborting 。 Stop. 


终端 操作 步骤 的 效果 如 图 7-11 所 示 。 



































Oe 会 ansen 一 -bash 一 84x26 





lansendeiMac-2:~ ansen$ cd ~ 

lansendeiMac-2:~ ansen$ touch .bash_profile 

lansendeiMac-2:~ ansen$ open -e .bash_profile 

lansendeiMac-2:~ ansen$ source .bash_profile 

lansendeiMac-2:~ ansen$ ndk-buitd 

Android NDK: Could not find application project directory ! 

Android NDK: Please define the NDK_PROJECT_PATH variable to point to jit。 
/Users/ansen/Library/Android/sdk/ndk-bundle/build/core/build-local.mk:151: 
id NDK: Aborting 。 Stop. 

ansendeliMac-2:~ ansen$ 有 





7-11 加 入 NDK 环境 变量 
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7.7.4 什么 是 JNI 


JNI 是 Java Native Interface 的 缩写 , 提供 了 若干 的 API 实现 Java 和 其 他 语言 的 通信 (主要 是 C 
和 C++) 。 从 Java 1.1 开始 ，JNI 标准 成 为 Java 平台 的 一 部 分 ， 人 允许 Java 代码 和 其 他 语言 写 的 代 
码 进行 交互 。 

JNI 一 开始 是 为 了 本 地 已 编译 语言 (尤其 是 C 和 C++) 而 设计 的 ， 但 是 它 并 不 妨碍 你 使 用 其 
他 编程 语言 ， 只 要 调用 约定 受 支 持 就 可 以 了 。 

使 用 Java 与 本 地 已 编译 的 代码 交互 ， 通 常会 丧失 平台 可 移植 性 。 但 是 ， 有 些 情况 下 这 样 做 是 
可 以 接受 的 ， 甚 至 是 必须 的 。 例 如 ， 使 用 一 些 旧 的 库 ， 与 硬件 、 操 作 系统 进 行 交 互 ， 或 者 为 了 提高 
程序 的 性 能 。JNI 标准 至 少 要 保证 本 地 代码 能 工作 在 任何 Java 虚拟 机 环境 。 





7.7.5 ”NDK 与 JNI 的 简单 使 用 


1. 生成 头 文件 

首先 创建 一 个 JNITest 类 与 MainActivity 路 径 同 级 ， 其 中 包含 一 个 native 方法 。 

Package com.ansen.jnitest; 

/rw 

* Q@author ansen 

* @create time 2017-09-12 

Dad 

Public class JNITest { 

public native int Plus (int x，int y);// 这 个 是 需 用 Cc 语言 实现 的 函数 

} 

打开 Android Studio 的 终端 Terminal) ， 默 认 是 在 当前 项 目 路 径 ， 需 要 用 cd 命令 定向 到 项 目 
的 Java 目录 : 

cd app/src/main/java 

接着 用 javah 命令 生成 .h 文件 。 后 面 跟着 的 是 包 名 .类 名 ， 命 令 执行 完成 后 ， 在 当前 目录 下 会 
生成 一 个 .h 头 文件 。 

javah com.ansen.jnitest.JNITest 

2. C 代码 实现 头 文件 

接 下 来 ， 在 JniTest/app/src/main 目录 下 新 建 一 个 名 字 为 jni 的 目录 ， 然 后 将 刚才 生成 的 .h 文件 
剪 切 过 来 ， 并 且 在 jni 下 新 建 一 个 文件 JNITestc， 内 容 如 下 : 

#include <jni.h> 

#include "com ansen jnitest JNITest.h" 

#ifdef ” ”cplusplus // 最 好 有 这 个 ， 否则 可 能 会 被 编译 器 改 了 函数 名 字 


extern "C" { 
#endif 





JNIEXPORT jint JNICALL Java com ansen jnitest JNITest plus 
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(JNIEnv * env, jclass cla, jint x, jint y) 


return Xx + y? 
} 
#ifdef cplusplus 
} 
#engdif 
这 个 文件 主要 实现 了 生成 头 文件 的 方法 ， 并 将 传 入 的 两 个 参数 相 加 。 
3. 配置 NDK 
打开 JniTest/app 下 的 build.gradle 文件 ， 在 defaultConfig 节点 中 添加 以 下 代码 : 
ndkf 
moduleName "mylib"// 生 成 的 so 名 字 , 也 是 1ibname 
I Tale ee Jed et ed. Yo 
abiFilters "armeabi","armeabi-vla", "x86" 
} 


单独 解释 一 下 abiFilters。 上 面 的 代码 指定 了 三 种 abi 体系 结构 下 的 so 库 ， 现 在 市 面 上 90% 的 
手机 都 是 ARM 架构 的 CPU， 所 以 一 般 情况 只 需要 编译 armeabi-v7a 架构 即 可 。 毕 竟 打 包 apk 时 里 
面 多 几 个 so 文件 也 会 让 包 变 得 很 大 。 

打开 JniTest/gradle.properties 文件 ， 尾 部 加 上 如 下 代码 : 


android.useDeprecatedNdk=true 


在 Android Studio 中 修改 文件 的 截图 如 图 7-12 所 示 。 




















CaJniTest Dapp ) 全 bulldgradle 
EF Project = 国定 条" 有 他 appx 
. Y CJniTest ~/Documents/git/github/JniTest 1 apply plugin: ‘com.android.application' 
SS * DO.grade 2 
网 ， 口 ,dea 3 android 大 
< a 4 compilesdkVersion 25 
7 四 app ; buildToolsVersion "26.9.9" 
号 » Dbuild 6 defaultConfig { 
9 Dsre 7 applicationId “com.ansen. jnitest" 
昌 8 minsdkVersion 15 
疝 * OandroidTest 9 targetSdkVersion 25 
? Y Omain 0 versionCode 1 
Y Djava 1 VersionName "1,0" 
Y comansenin 2 testInstrumentationRunner “android.support.test. ru 
上 
v 加 MainActivity moduleName "mylib"// 生 成 的 50 名 字 , 也 是 1ibname 
入 TE ldLibs "Wu 
com_ansen_jnitest_JNITest.h abiFitters ", "armeabi-v7a", "x86" 
sb NITest.c 上 消 
» Cires 
康 AndroidManifest.xml buildTypes { 
站 本 release { 
> minifyEnabled false 
目 i proguardFites getDefauttpProguardFite( "proguard| 
iml 
uild.gradle 全 } 
proguard-mules.pro 于 
上 品 build dependencies { 
§ * 串 gradle compite fileTree(dir: "Libs'，inctude: ['*.jar']) 
.gitignore androidTestConpile( 'com.android. support. test.espresso: 
FE exclude group: 'com.android.support', module: ‘'sup| 
要 » 
中 [i gradle.properties compile ‘com.android.support:appcompat-v7:25,3,1° 
Egradlew compile “com.andro: pport .constraint:constraint-Lay| 
ron hat testCompite ‘junit:junit:4.12' 





x 


图 7-12 修改 文件 
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4. 调用 native 方法 
在 MainActivity 中 使 用 static 代码 块 的 方式 加 载 so 库 ， 在 oncreate 方法 中 创建 一 个 JNITest 对 
象 ， 直 接 调 用 plus 方法 即 可 。 


Public class MainActivity extends AppCompatActivity { 
Q@Override 
Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


JNITest jniTest=new JNITest(); 


TextView tvResult= (TextView) findViewById(R.id.tv result); 
tvResult .setText ("运行 结果 : "+jniTest.plus (100,10)); 


} 

static { 
//libname 就 是 我 们 在 app/build.gradle 中 moduleName 的 值 
System.loadLibrary ("mylib"); 

’ 


} 


直接 运行 代码 ， 效 果 如 图 7-13 所 示 。 

这 里 并 没有 编译 so 文件 ， 为 什么 加 载 so 库 时 没 报 错 并 且 还 能 运行 成 功 呢 ? 那 是 因为 Android 
Studio 帮 有 我 们 编译 了 so 文件 , 并且 打 包 到 apk 中 了 。 在 项 目的 build 文件 夹 下 可 以 看 到 编译 后 的 so 
文件 ， 如 图 7-14 所 示 。 

D3 JniTest D3app build 门 intermediates ) 门 ndk) [ 


= 全 未 阁 "全 


Y CajniTest ~/Pocuments/git/github/JniTest 


.gradle 





ED) 
国 
加 


» 门 generated 
» Dassets 
» Dblame 
» Dclasses 
» Dincremental 
» Dincremental-safeguard 
» Djnilibs 
» Dmanifest 
» Dmanifests 


2: Structure 


@ Captures 


Y armeabi 
矶 libmylib.so 


Y Darmeabi-v7a 


OA 
矶 libmylib.so 


JniTest 





运行 结果 :110 





d Variants 


图 7-13 运行 结果 图 7-14 编译 后 的 so 文件 
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5. 直接 使 用 编译 好 的 so 文件 

上 一 个 步骤 虽然 能 直接 使 用 ， 但 是 每 次 运行 都 会 编译 so 文件 (不 确定 性 ) ， 还 有 一 个 情况 就 
是 不 可 能 把 C/C++ 代码 直接 给 别人 编译 运行 ， 所 以 在 某 些 情况 下 需要 我 们 手动 编译 so 文件 。 

首先 在 JniTest/app/src/main 目录 下 新 建 一 个 名 字 为 jniLibs 的 日 录 , 然后 将 编译 后 的 so 文件 复 
制 过 来 ， 连 同 目录 一 起 复制 。 当 需要 加 载 so 文件 时 ， 默 认 会 去 src/main/jniLibs 目录 下 查找 。 接 下 
来 ， 注 释 掉 app/build.gradle 中 配置 的 ndk 代码 。 

项 目 修 改 后 的 截图 如 图 7-15 所 示 。 





区 AndroldManifest.xml butleTypes { 
» Dtest release { 
日 kionore minifyEnabted fatse 


proguardFites getDefauttProguardFitef 'proguard-android,txt')，'proguard-rutes,pro 
} 





图 7-15 修改 项 目 
运行 修改 后 的 代码 ， 结 果 与 之 前 一 样 。 


7.8 使 用 SourceTree 上 传 项 目 到 GitHub 


在 工作 中 ， 一 般 都 是 多 人 开发 一 个 项 目 、 维 护 一 套 代码 ， 这 时 就 需要 一 个 版 本 控制 系统 来 管 
理 我 们 的 项 目 。 


7.8.1 什么 是 Git 


Git 是 一 个 免费 、 开 源 的 分 布 式 版 本 控制 系统 (Version Control System，VCS) ， 可 以 有 效 、 
高 速 地 处 理 从 很 小 到 非常 大 的 项 目 版 本 管理 ,Git 是 Linus Torvalds 为 了 帮助 管理 Linux 内 核 开发 而 
开发 的 一 个 开放 源码 的 版 本 控制 软件 。 

2005 年 Linux 内 核 开发 社区 正面 临 严峻 的 挑战 : 不 能 继续 使 用 BitKeeper (一 个 分 布 式 版 本 控 
制 系统 ) ， 原 因 是 当时 Bitkeeper 著作 权 所 有 者 决定 收回 授权 ， 内 核 开 发 团队 与 其 协商 无 果 ， 同 时 
又 没有 其 他 的 SCM (Software Configuration Management) 可 以 满足 分 布 式 系统 的 需求 。 

Linus Torvalds 花费 一 周 的 时 间 开 发 了 Git， 最 初 Git 的 开发 是 为 了 辅助 Linux 内 核 开发 。 实际 
0 Git 来 作为 内 核 开发 的 版 本 控制 系统 时 , 世界 开源 社 群 的 反对 

不 少 ， 最 大 的 理由 是 Git 太 艰 汲 难 懂 ， 从 Git 的 内 部 工作 机 制 来 讲 ， 的 确 是 这 样 。 随 着 开发 的 
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深入 ，Git 的 正常 使 用 都 由 一 些 友好 的 脚本 命令 来 执行 ， 使 Git 变 得 非常 好 用 ， 即 使 是 用 来 管理 我 
们 自己 的 开发 项 目 ，Git 也 是 一 个 友好 、 有 力 的 工具 。 现 在 ， 越 来 越 多 的 著名 项 目 采 用 Git 来 管理 
开发 项 目 。 


7.8.2 什么 是 GitHub 


GitHub 是 一 个 面向 开源 及 私有 软件 项 目的 托管 平台 ， 因 为 只 支持 Git 作为 唯一 的 版 本 库 格 式 
进行 托管 ， 故 名 为 GitHub。 

GitHub 于 2008 年 4 月 10 日 正式 上 线 , 除 了 Git 代码 仓库 托管 以 及 基本 的 Web 管理 界面 以 外 ， 
还 提供 了 订阅 、 讨 论 组 、 文 本 泻 染 、 在 线 文件 编辑 器 、 协 作 图 谱 〈 报 表 ) 、 代 码 片段 分 享 (Gist) 
等 功能 。 目 前 ， 其 注册 用 户 已 经 超过 900 万 ， 托 管 版 本 数量 也 是 非常 之 多 ， 其 中 不 乏 知 名 开源 项 目 
Ruby on Rails、jQuery、Python 等 。 

在 GitHub 上 提交 开源 项 目 是 免费 的 ， 提 交 私 人 项 目 〈 不 想 开 源 ) 是 收费 的 。 收 费 标 准 是 7 美 
元 一 个 月 ， 支 持 5 个 私有 项 目 。 如 果 项 目 参与 的 人 较 多 ， 则 费用 也 会 增加 。 

基于 Git 的 其 他 托管 平台 还 有 几 个 。 

1. GitLib 


GitLab 是 一 个 用 于 仓库 管理 系统 的 开源 项 目 。 使 用 Git 作为 代码 管理 工具 , 并 在 此 基础 上 搭建 
Web 服务 。 可 以 通过 Web 界面 访问 公开 的 或 者 私有 的 项 目 。 它 拥有 与 GitHub 类 似 的 功能 ， 能 够 
浏览 源 代码 ,管理 缺陷 和 注释 ， 可 以 管理 团队 对 仓库 的 访问 ， 易于 浏览 提交 过 的 版 本 ,并 且 提 供 了 

-个 文件 历史 库 。 团 队 成 员 可 以 利用 内 置 的 简单 聊天 程序 (Wall) 进行 交流 。 它 还 提供 了 一 个 代码 
片段 收集 功能 ， 可 以 轻松 实现 代码 复 用 。 下 载 安 装 地 址 为 https://bitnami.com/stack/gitlab/installer。 
公司 可 以 用 GitLab 来 搭建 自己 的 代码 管理 工具 ， 供 公司 内 部 使 用 。 

2. BitBucket 


BitBucket 是 一 家 源 代码 托管 网 站 ， 采 用 Mercurial 和 Git 作为 分 布 式 版 本 控制 系统 ， 同 时 提供 
商业 计划 和 免费 账户 。 

BitBucket 可 以 创建 免费 的 私有 项 目 ， 只 能 有 5 个 人 参与 项 目 ， 如 果 超 过 5 个 人 就 需要 收费 ， 
适合 刚 创业 的 小 团队 。BitBucket 的 访问 速度 比 GitHub 要 慢 。 

3. 码 云 

码 云 是 中 国人 自己 的 代码 托管 网 站 ， 开 源 中 国 社区 主推 ， 也 是 基于 Git 的 。 相 对 于 GitHub、 
GitLib、BitBucket， 码 云 具 有 以 下 几 点 优势 : 

@ ”访问 速度 快 ， 毕 竟 服 务 器 在 国内 。 

@ ”更 适合 中 国人 的 使 用 习惯 ， 界 面 都 是 中 文 的 。 

不 管 私 有 项 目 还 是 开源 项 目 都 不 收费 。 


当然 ， 也 有 一 些 缺 点 : 


@ ”如 果 你 是 一 个 开源 项 目的 作者 ， 肯定 希望 自己 的 项 目 被 越 来 越 多 的 人 使 用 ，GitHub 的 曝光 率 
更 高 ， 并 且 是 全 球 性 。 
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”如 果 你 是 企业 ， 用 码 云 创建 私有 项 目的 话 ， 你 的 代码 就 在 别人 的 服务 器 上 ， 安 全 性 是 一 个 问 
题 。 


因此 , 如 果 你 是 开源 项 目 作 者 , 建议 将 项 目 提交 到 GitHub。 如 果 是 公司 , 建议 自己 搭建 GitLib。 
如 果 是 小 公司 ， 为 了 省 钱 ， 可 以 选择 BitBucket 和 码 云 的 私有 库 。 


7.8.3 什么 是 SourceTree 


SourceTree 是 Windows 和 Mac OS X 下 免费 的 Git 和 Hg 客户 端 管理 工具 , 同时 也 是 Mercurial 
和 Subversion 版 本 控制 系统 工具 ， 支 持 创建 、 克 隆 、 提 交 、push、pull 和 合并 等 操作 。 

SourceTree 拥有 一 个 精美 简洁 的 界面 ， 大 大 简化 了 开发 者 与 代码 库 之 间 的 Git 操作 方式 ， 对 于 
那些 不 熟悉 Git 命令 的 开发 者 来 说 非常 实用 。 

每 天 我 们 都 要 使 用 Git 提交 、 更 新 与 合并 代码 ， 记 住 这 些 Git 命令 是 一 件 很 困难 的 事 ， 用 
SourceTree 就 简单 了 ， 新 手 也 能 立马 上 手 。 


7.8.4 使 用 SourceTree 操作 GitHub 


1. Git 下载 

GitHub 是 基于 Git 进行 版 本 控制 的 ， 所 以 先 要 下 载 Git 客户 端 。 官 方 下 载 页 面 地 址 为 
https:/Wgit-scm.com/downloads。 有 四 个 客户 端 可 供 选 择 ， 分 别 是 Mac、Windwos、Linux 和 Solaris， 
可 根据 自己 的 操作 系统 进行 选择 。 

2. SourceTree 下 载 

SourceTree 的 官网 地 址 为 https://www.sourcetreeapp.com/。 在 官网 首页 就 有 “Download for Mac 
OS X” 下 载 按钮 。 (因为 笔者 的 电脑 是 Mac 系统 ， 所 以 是 for Mac OS X， 各 操作 系统 显示 的 名 字 
略 有 区 别 。) 

3. 安装 Git 与 SourceTree 

下 载 了 Git 与 SourceTree 客户 端 后 ， 安 装 过 程 很 简单 ， 这 里 就 不 解释 了 。 安 装 SourceTree 时 

需要 一 个 Atlassian 账户 ， 按 照 提示 注册 即 可 。 需 要 注意 的 是 ， 先 安装 Git 再 安装 SourceTree。 

4. 注册 GitHub 账号 和 创建 项 目 

GitHub 的 官网 地 址 为 https://github.com/。 用 浏览 器 打开 官网 链接 , 显示 如 图 7-16 所 示 的 页 面 。 
在 官网 首页 可 以 直接 测试 ， 输 入 用 户 名 、 邮 箱 和 密码 ， 然 后 点 击 “Sign up for GitHub ”按钮 即 可 。 
GitHub 会 给 注册 邮箱 发 送 一 条 激活 的 邮件 ， 激 活 之 后 就 算 注册 成 功 了 。 
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ohhubcom 





Explore ”Marketplace ”pricing Signin ， Sign up 


Built for 
developers 


open source 


business, 


Sign up for GitHub 


图 7-16 在 网 站 首页 测试 


点 击 激活 邮件 中 的 Verify email address 链接 ,直接 进入 GitHub 首页 , 并 且 显 示 登 录 成 功 状态 。 
登录 成 功 之 后 的 效果 如 图 7-17 所 示 。 (这 是 笔者 的 账号 登录 之 后 显示 的 首页 。) 


> @ GitHub, Inc. [US] httpsi//github.com 女 


Learn Git and GitHub without any code! 


Using the Hello World guide, you'll create a repository, start a branch, 
Write comments, and open a pull request 


Read the guide Start a project 














图 7-17 登录 成 功 


现在 将 之 前 封装 的 OkHttpEncapsulation 项 目 提交 到 GitHub 上 ,让 更 多 人 使 用 封装 的 


击 GitHub 首页 的 “Start a project” 按 钮 新 建 一 个 项 目 ， 如 图 7-18 所 示 。 





框架 。 点 
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Create a new repository 


A repository contains all the fiies for your proiect, ncluding the revision nistory 


Owner 





gongiul23- / 
Great repository names are short and memorabie. Need inspiration? How about fluffy-barnacle. 


Description (er 









paom GN, ne Tems prvecy secty Sums He Contac cup al Traning Shop Blog Apoul 


图 7-18 新 建 项 目 








Repository name 输入 框 用 于 填写 OkHttpEncapsulation， 和 项 目 名 称 保持 一 致 。 项 目 描述 可 不 
写 , 项 目 类 别 选 择 “Public”， 选 中 是 否 初始 化 阅读 文档 的 单 选 按 钮 ， 毕 竞 一 个 项 目 没有 描述 文档 ， 
其 他 人 也 不 知道 你 的 项 目 是 干什么 用 的 。 最 后 点 击 “Create repository” 按 钮 ， 进 入 项 目 创建 成 功 页 


面 ， 如 图 7-19 所 示 。 




















gongju123 / OkHttpEncapsulation OwWetch- 0 育 ster 0 YFok 0 
Go code issues 0 Pul requests projects 0 Seriings 。 Insight 
No description, website, or topics provided Edn 
Add topics 
D1commit bibranch 


snc master ”New pull raquost 





README.md Initial comm 


国 README.md 


https://04thub comgpngjeaaa/obetpencaps 


Open in pesktop Download ZIP 


OkHttpEncapsulation 





D2017 ckhua ne。 Terms Prvacy Securny Siatus Help Contact Gh Ap Training Shop Slog Abeut 


图 7-19 创建 项 目 成 功 





默认 显示 的 是 Code 列表 , 看 到 文件 列表 中 只 有 一 个 README.md 文件 , 这 还 是 勾 选 了 初始 化 
阅读 文件 ， 不 然 一 个 文件 都 没有 ， 然 后 点 击 “Clone or download” 的 下 拉 按 钮 ， 可 以 看 到 项 目的 
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Git 地 址 ，Git 地 址 右 侧 有 一 个 复制 按钮 ， 点 击 此 按钮 即 可 将 Git 地 址 复制 到 剪贴 板 中 。 
右上 角 还 有 三 个 按钮 ， 即 Watch、Star、Fork。 
(1) Watch 
Watch 即 观察 ， 点 击 Watch 按钮 ， 可 以 看 到 如 图 7-20 所 示 的 列表 。 





OWwWatch- 0 让 Star 0 Yrork 0 
Notifications 
Y Notwatching 

Be notified when participating or 


@mentioned. 批 


Watching 
Be notified of all conversations. 


lgnoring 
Never be notified. 





图 7-20 “Watch 下 拉 列 表 


对 于 别人 的 项 目 ， 默 认 自 己 都 处 于 Not watching 状态 。 选 择 Watching 后 ， 表 示 以 后 会 关注 这 
个 项 目的 所 有 动态 ， 这 个 项 目 以 后 只 要 发 生变 动 ， 如 被 别人 提交 了 Pull Request、 被 别人 发 起 了 问 
题 等 ， 都 会 在 自己 的 个 人 通知 中 心 收 到 一 条 通知 消息 。 如 果 设 置 了 个 人 邮箱 ,那么 该 邮箱 也 可 能 会 
收 到 相应 的 邮件 。 

如 图 7-21 所 示 ，Watching 了 开源 项 目 android-cn/android-discuss 后 , 任何 人 只 要 在 这 个 项 目下 
提交 了 问题 或 者 在 问题 下 面 有 任何 留言 ， 通 知 中 心 就 会 给 通知 。 如 果 配 置 了 邮箱 ， 还 可 能 会 因此 不 
断 地 收 到 通知 邮件 。 











android-cr/android-discuss Y 
四 网 络 请 求 的 思考 SI] nousao 和 vv 
名 [ 问 特 ] 表 单 提交 的 输入 验证 ， 大 家 有 不 有 院子 好 的 方案 呢 ? 世 5 hours ago dx* 
| 大 家 有 没有 做 过 后 台 定 时 任务 的 ? 都 是 怎么 做 的 ?比如 我 要 每 隔 .… 曾 !，7housao dv 
© shrinkReleaseMultiDexComponents FAILED after enabling pr... 图 :sosao dx v 
人 加 FrameLayout 中 有 个 ImageView， 通 过 ImageView.layout(Lbrnb.… | 17 days ago dx v 
四 [问答 如 何 实现 微 信 的 延 时 启动 界面 ? al 17 days ago 4* vv 
名 关于 Activity 被 回收 ，Fragment 还 在 的 问题 Bah 20days ago dx vv 
图 7-21 查看 通知 


如 果 不 想 接收 这 个 项 目的 所 有 通知 ， 那 么 点 击 Not watching 即 可 。 


(2 ) Star 

Star 解释 为 关注 或 者 点 赞 更 为 合适 。 当 你 点 击 Star 时 ， 表 示 喜 欢 这 个 项 目 ， 或 者 通俗 点 地 将 其 
理解 为 朋友 圈 的 点 赞 ， 表 示 对 这 个 项 目的 支持 。 

不 过 ， 相 对 于 朋友 圈 的 点 赞 ，GitHub 中 有 一 个 列表 ， 专 门 收 集 了 所 有 Star 过 的 项 目 ， 点 击 
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GitHub 个 人 头像 ,可 以 看 到 Your stars 条 目 ， 点 击 就 可 以 查看 Star 
过 的 所 有 项 目 ， 如 图 7-22 所 示 。 





(3 ) Fork 
当选 择 Fork 时 ， 相 当 于 自己 有 了 一 份 原 项 目的 备份 。 当 然 ， “| Ss pe 
这 个 备份 只 是 针对 当时 的 项 目 文件 ， 如 果 后 续 原 项 目 文件 发 生 改 
变 ， 就 必须 通过 其 他 的 方式 去 同步 。 Your profile 
一 般 来 说 ,我 们 不 需要 使 用 Fork 这 个 功能 ， 除 非 有 一 些 项 目 
可 能 存在 Bug 或 者 可 以 继续 优化 的 地 方 ， 想 帮助 原 项 目 作 者 去 完 Your Gists 
善 这 个 项 目 或 者 单纯 地 想 在 原来 项 目的 基础 上 维护 一 个 属于 自己 
的 项 目 。 例 如 ， 我 的 AndroidWeekly 客户 端 ， 你 可 以 复制 一 份 ， Hale 
然后 自己 对 这 个 项 目 进行 修改 完善 。 当 你 觉得 项 目 没 问 题 了 ， 就 Sngs 
可 以 尝试 发 起 Pull Request 给 原 项 目 作者 了 。 接 下 来 ， 静 静 等 待 他 Signout 
的 邮件 通知 。 


2 图 7-22 Your stars 
很 多 人 都 使 用 Fork, 将 Fork 当 作 类 似 收藏 的 功能 ， 每 次 看 到 


-个 好 的 项 目 就 Fork。 因 为 这 样 ， 就 可 以 在 我 的 仓库 列表 下 查看 Fork 的 项 目 了 。 其 实 完全 可 以 使 
用 Star 来 达到 这 个 目的 。 
5. SourceTree 从 GitHub 上 获取 项 目 


首先 从 GitHub 项 目 首页 复制 Git 链接 ， 例 如 刚 创建 的 项 目 Git 地 址 : 
https://github.com/gongjul23/OkHttpEncapsulation.git 
打开 SourceTree i 此 时 首页 什么 都 没有 ， 一 片 空白 ， 如 图 7-23 所 示 。 











图 7-23 查看 本 地 仓库 





点 击 首页 的 Clone 按钮 ， 出 现 如 图 7-24 所 示 的 页 面 ， 然 后 将 Git 地 址 填写 到 第 一 个 输入 框 ， 
下 面 的 项 目 保存 路 径 、 项 目 名 称 会 自动 生成 ,自己 也 可 以 根据 实际 需求 进行 修改 。 最 后 点 击 “ 克 隆 ” 
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Clone 


Cloning fs even easier if you set up a remote accouni 


hutps// github com/gongju123/ OkHupEncaps ulotion git 














Cseriansen\Documents OntpEncapsulntion 











OpnipEncaps ulation 





Local Folder 
[7 











Tee 





图 7-24 ”克隆 项 目 
点 击 “ 克 隆 ” 按 钮 之 后 进入 关联 用 户 对 话 框 ， 如 图 7-25 所 示 。 在 “全 名 ”文本 框 中 输入 自己 
的 名 字 , 或 者 用 默认 生成 的 名 字 。 接 下 来 ,填写 自己 的 邮箱 地 址 ， 随 便 填 写 一 个 也 可 以 , 但 是 提交 
代码 时 可 以 看 到 这 些 信息 。 填 写真 实 的 信息 ,便于 区 分 。 点 击 “ 确 定 ” 按 钮 ， 这 个 项 目 就 同步 到 了 
本 地 。 


OkHrtpEncapsulation 











图 7-25 提交 相关 联 的 用 户 详情 


此 时 ， 进 入 了 可 视 化 的 项 目 Git 首页 ， 可 以 看 到 之 前 的 提交 记录 ， 还 有 分 支 信息 ， 如 图 7-26 


所 示 。 
克隆 项 目 时 指定 了 本 地 保存 路 径 ， 打 开 这 个 文件 来， 其 中 包含 一 个 git 隐藏 文件 夹 和 一 个 初始 


化 的 md 文件， 如 图 7-27 所 示 。 
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图 7-26 项 目的 Git 首页 图 7-27 查看 克隆 的 文件 
6. SourceTree 提交 文件 到 GitHub 


步骤 014 将 之 前 项 目 文件 夹 的 所 有 文件 复制 到 Git 地 址 生成 的 文件 夹 下 。 复 制 成 功 之 后 ， 再 
次 进入 SourceTree 首页 ， 可 以 看 到 “未 暂 存 文件 ”列表 框 中 包含 刚刚 复制 的 文件 ， 如 图 7-28 所 示 。 














ED 
本 要 
DD ss origin/macter 
文件 状态 日 志 / 历史 Esgd 
图 7-28 未 暂 存 文件 


步骤 024 点 击 “ 暂 存 所 有 ”按钮 ， 然 后 在 “提交 选项 ”输入 框 中 输入 要 提交 这 些 内 容 的 备注 ， 
例如 第 一 次 提交 时 可 以 填写 “第 一 次 提交 "， 然 后 选中 “立即 推送 变更 到 ” 复 选 框 ， 如 图 7-29 所 示 。 
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as 
CE cm 
文件 议 态 日 志 / 历史 现 家 











图 7-29 输入 提交 选项 信息 


步骤 034 点 击 “提交 ”按钮 ， 弹 出 如 图 7-30 所 示 的 GitHub 登录 窗口 。 因 为 操作 的 是 GitHub 
网 站 的 Git， 所 以 需要 登录 这 个 网 站 的 账号 来 授权 。 


GitHub Login 





GitHub 
Login 





( X ) Cancel 


Don' thave an account? Sign up 


图 7-30 ”登录 窗口 
步 野 044 输入 用 户 名 和 密码 ， 点击“Login” 按钮 ， 开 始 将 代码 提交 到 服务 器 ， 提 交 成 功 后 效 
果 如 图 7-31 所 示 。 


如 何 确保 代码 提交 到 了 服务 器 呢 ? 用 浏览 器 打开 GitHub， 登 录 账号 ， 登 录 成 功 之 后 点 击 头像 
会 弹出 下 拉 列 表 ， 再 点 击 下 拉 列 表 中 的 “Your profile” 命 令 ， 如 图 7-32 所 示 。 
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Pushing to hfpsy/gihubconvacngjul237OkHttpEncapuulation git 
To httpsy/githubcom/gongjul23/OkHttpEncapsulation git 


Signed inas 
bhH3Sac-cdd1373 master > master gongju123 


updating ocal tracking ref refs/remotes/originfmaster he 


mf Your stars 


Your Gists 


Help 
Settings 
Sign out 





图 7-31 将 代码 提交 到 服务 器 图 7-32 ”点击 “Your profile” 
接 下 来 会 进入 用 户 首页 ， 在 首页 中 找到 提交 的 那个 项 目 OkHttpEncapsulation， 点 击 项 目 名 称 
进入 该 项 目 首页 。 在 项 目 主页 可 以 明显 地 看 到 之 前 提交 的 文件 ， 如 图 7-33 所 示 。 至 此 提交 代码 就 
算 完 成 了 。 








gongju123 / OkHttpEncapsulation Owach» 0 unstar 1 Yrok 0 
Ocode Dissueso Pull requests 0 prolects 0 wd OSsetings 。 Insights- 
No description, website, or topics provided Eh 
D2 commits bibranch Oreleasos M2contributors 











Mmaster™ New pull request createnew me Uplosd es Find me 
人 ansen6686 划一 次 提交 Liatest commit eae1373 2 daysago 
[CT 
Mapp 


a gradlerwrapper 
a oxhttpencapsulaton 


目 ohionore 











README.md 





buid.gradie 
gradle.propertios 2 days ago 
目 gradlew 2 days ago 
和 gradlew bat 2 days ago 
settings.gradle 2 days ago 





README.md 








OkHttpEncapsulation 

图 7-33 看 到 提交 的 文件 
7. SourceTree 项 目 首页 常见 按钮 的 使 用 
在 SourceTree 项 目 首页 中 ， 常 用 的 有 “提交 ”“ 推 送 ”“ 拉 取 ”“ 获 取 ” 按 钮 ， 如 图 7-34 所 





示 。 


292 | Android App 开发 从 入 门 到 精通 








ws Es C3 昌 呈 。 作 。 拉 交 
orgvmaster BoignvHEAD Update READ 2017-09- gongjul f4d6535 
Emd 08 









ptures 
+ vexternalnativeeuji ~ 
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图 7-34 SourceTree 项目 首页 的 常用 按钮 
提交 : 代码 提交 到 本 地 ， 这 时 还 没有 推送 到 Git 服务 器 上 。 
推送 : 代码 推送 到 Git 服务 器 上 。 
拉 取 : 拉 取 服务 器 的 版 本 到 本 地 ， 会 同步 最 新 版 本 的 代码 。 
获取 : 将 本 地 的 版 本 与 Git 服务 器 的 版 本 进行 对 比 。 如 果 服 务 器 版 本 大 于 本 地 ， 拉 取 的 图 标 
就 会 显示 一 个 数字 。 这 时 只 会 提示 与 Git 服务 器 相差 几 个 版 本 ， 但 是 不 会 合并 代码 。 
正常 情况 下 如 何 使 用 呢 ? 
@” 一 般 提 交代 码 流程 是 : 提交 一 推送 。 
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@ 同步 服务 器 代码 流程 是 : 获取 一 拉 取 。 

如 果 发 生 冲 突 了 怎么 处 理 呢 ? 

如 果 你 和 别人 同时 修改 某 个 文件 ， 恰 好 修改 的 是 同一 个 代码 块 ， 就 会 发 生 冲 突 ， 一 般 是 手动 
解决 冲突 。 发 生 冲 突 后 打开 Android Studio， 查 看 项 目 中 哪里 有 报错 ， 因 为 发 生 冲 突 时 会 有 一 些 非 


代码 块 ，Android Studio 肯定 会 报错 。 删 除 那些 乱码 ， 再 次 提交 即 可 。 


7.9 将 项 目 发 布 到 JCenter 


前 面 使 用 自己 封装 的 OkHttp 项 目 时 ， 只 需要 在 app/build.gradle 文件 中 加 入 一 行 代码 就 能 使 用 
项 目 。 
compile 'com.ansen.http:okhttpencapsulation:1.0.1' 


那 是 因为 之 前 就 把 封装 的 模块 提交 到 了 JCenter 服务 器 , 所 以 Android Studio 从 JCenter 服务 器 
下 载 类 库 。 
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7.9.1 提交 项 目 到 JCenter 


做 好 一 个 项 目 或 者 项 目 中 有 一 些 好 的 模块 想 分 享 给 别人 使 用 时 ， 首 先 将 代码 提交 到 GitHub 上 
开源 ， 但 是 这 样 还 不 够 ， 别 人 拿 你 的 代码 作为 模块 依赖 太 麻 烦 了 ， 比 较 酷 的 方法 是 一 行 代码 引用 。 

1. 需要 一 个 JCenter 账号 

JCenter 网 站 注册 有 点 麻烦 ， 包 含 企 业 版 和 个 人 免费 版 两 种 方式 ， 其 中 个 人 版 的 项 目 必须 要 开 
源 ， 个 人 注册 地 址 如 下 : 

https://bintray.com/signup/oss 

一 定 要 注意 ， 不 要 注册 为 企业 版 ， 因 为 无 法 直接 切换 成 个 人 版 ， 必 须 等 试用 期 过 了 重新 注册 。 
另外 ， 注 册 邮 箱 不 能 是 国内 163 邮箱 或 者 qq 邮箱 ， 可 以 用 Google 等 邮箱 注册 。 

2. 上 传 项 目 到 JCenter 


(1) 在 JCenter 上 创建 Repository 
登录 JCenter 账号 ， 进 入 用 户 首页 ， 点 击 “Add New Repository” 按 钮 ， 如 图 7-35 所 示 。 





Cm htpsylbintraycomyanh 





对 > JFog Bintray 


Emall pvatewomemal@gmal com ©) 





Member Since AuR 14,2017 





DD AddNeworganizaton Worldwide 
Totter 


Github 





Google 





图 7-35 ”点击 “Add New Repository” 按 钮 


进入 如 图 7-36 所 示 的 Add New Repository 页 面 ， 在 “Name” 文 本 框 中 输入 模块 名 称 
“okhttpencapsulation ”， 将 “Type” 设 置 为 “Maven”， 然 后 点 击 “Create” 按 钮 ，Repository 就 
创建 成 功 了 。 
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7-36 创建 Repository 
(2 ) 在 Android Studio 中 添加 代码 
在 项 目的 build.gradle 中 加 入 如 下 代码 : 


classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1' 
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.4' 


build.gradle 修改 后 的 效果 如 图 7-37 所 示 。 





OkHttpEncapsulation 全 bulld.oradle 


应 project 二 昌 二 三- 全 (DOkHttpEncapsulation x 
上 okhetpEncapsulation -~/Dquments/oif 3 77 Top-iever Buiid Fiie where you can add configuration options Common TO all sub-projects/modules 


>» DO.idea 3 buildscript { 

4 repositories { 
jcenter() 
> bu ; 

» Dgradle 7 dependencies { 





» Caokhttpencapsuiation classpath ‘com.android.tools.build:gradle:2. 


‘Dbuild.gradle 


oradle. Propertres 





they belong 





目 gradlew 
回 gradlew.bar - } 
Blocal.properties 6 } 

区 okHttpEncapsulation.iml 17 east 

目 EENoMEmd 本 
一 : 2 | 由 jcenter() 





7-37 ”build.gradle 修改 后 的 效果 


修改 要 上 传 的 模块 下 的 build.gradle， 例 如 这 里 的 路 径 OkHttpEncapsulation/okhttpencapsulation/build. 
gradle。 在 文件 尾部 增加 如 下 代码 : 


// 这 里 添加 下 面 两 行 代码 
apply Plugin: "com.github .dcendents.android-maven' 
apply Plugin: "com.jfrog.bintray'" 
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// 定义 两 个 链接 ， 下 面 会 用 到 

def siteUrl = 'https://github.com/ansen666/OkHttpEncapsulation' // 项 目 主页 

def gitUrl = 'https://github.com/ansen666/0kHttpEncapsulation.git' // Git 仓 
库 的 url 


group = "com.ansen.http" 

// 唯一 包 名 ,比如 compile 'com.ansen.http:okhttpencapsulation:1.0.1' 中 的 
com.ansen.http 就 是 这 里 配置 的 

version = "1.0.1" 

// 项 目 引 用 的 版 本 号 ， 比 如 compile 'com.ansen.http:okhttpencapsulation:1.0.1' 中 的 
1.0.1 就 是 这 里 配置 的 


install { 
repositories.mavenInstaller { 
// 生成 pom.xml 和 参数 
pom { 
project { 

Packaging "aar'" 
// 项 目 描述 ， 复 制 的 话 ， 这 里 需要 修改 。 
name 'okhttpencapsulation'// 可 选 ， 项 目 名 称 
description 'okhttp project describe'// 可 选 ， 项 目 描述 
url siteUrl // 项 目 主页 ， 这 里 是 引用 上 面 定义 好 的 


// 软 件 开源 协议 ， 现 在 一 般 都 是 apache License2.0， 复 制 的 话 ， 这 里 不 需要 修改 
licenses { 
license { 
name 'The Apache Software License, Version 2.0' 
url 'http://www.apache.org/licenses/LICENSE-2.0.txt" 


} 
// 填 写 开发 者 基本 信息 ， 复 制 的 话 ， 这 里 需要 修改 


developers { 
developer { 
id "ansen' // 开发 者 的 id 
name "ansen' // 开发 者 名 字 
email 'iprivateworkemail@gmail.com' // 开发 者 邮箱 


} 
// SCM， 复 制 的 话 ， 这 里 不 需要 修改 


Scm { 
connection gitUrl // Git 仓库 地 址 
developerConnection gitUrl // Git 仓库 地 址 
url siteUrl // 项 目 主页 


1 
// 生成 jar 包 的 上 task， 不 需要 修改 


task SourcesJar (上 type: Jar) { 
from android.sourceSets.main.java.srcDirs 
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classifier = "Sources'" 


有 


// 生成 jarDoc 的 task， 不 需要 修改 
task javadoc (type: Javadoc) { 

source = android.sourceSets .main.java.srcDirs 

classpath += Project.files(android.getBootClasspath () .join 

(File.pathSeparator)) 

// destinationDir = file("../javadoc/") 

failOnError false // 忽略 注释 语法 错误 ， 如果 用 jdk1 .8， 注 释 写 得 不 规范 就 不 能 编译 
} 


// 生成 javaDoc 的 jar， 不 需要 修改 
task javadocJar (type: Jar, dependsOn: javadoc) { 
classifier = 'javadoc' 
from javadoc.destinationDir 
下 
artifacts { 
archives javadocJar 
archives sourcesJar 


} 


// 这 里 是 读 取 Bintray 相关 的 信息 ， 上 传 项 目 到 GitHub 上 时 会 把 gradle 文件 传 上 去 ， 所 以 不 要 
把 账号 密码 的 信息 直接 写 在 这 里 ， 而 是 写 在 local .properties 中 ， 这 里 动态 读 取 。 
Properties properties = new Properties () 
properties.load (project .rootProject.file('local.properties') .newDataInputS 
tream()) 
bintray { 
user = properties.getProperty("bintray.user") // Bintray 的 用 户 名 
key = properties.getProperty ("bintray.apikey") // Bintray 刚才 保存 的 ApiKey 


configurations = ['archives'] 
pkg { 
repo = "okhttpencapsulation"//Repository 名 字 ， 需 要 自己 在 bintray 网 站 上 先 添加 
name = "okhttpencapsulation"// 发 布 到 Bintray 上 的 项 目 名 字 ， 这 里 的 名 字 不 是 
compile 'com.ansen.library:circleimage:1.0.1' 中 的 circleimage 
userOrg = 'anhui'//Bintray 的 组 织 id 
websiteUr1l = siteUrl 
vesUrl = gitUrl 
licenses = ["Apache-2.0"] 


publish = true // 是 否 是 公开 项 目 
j 
需要 时 直接 复制 代码 即 可 ， 然 后 修改 一 些 值 。 在 最 后 的 bintray 中 包含 从 local.properties 文件 
中 获取 用 户 名 和 APIKey。 这 是 保密 信息 ， 我 们 不 能 暴露 给 别人 ，build.gradle 文件 会 提交 到 Git 服 
务 器 上 ， 但 是 local.properties 文件 不 会 提交 。 
打开 OkHttpEncapsulation/local.properties 文件 ,在 尾部 添加 两 行 ， 这 个 Key 是 随意 修改 的 ， 是 
一 个 错误 的 Key， 需 要 自己 去 替换 : 


bintray.user=anhui 
bintray.apikey=ac8137c9138a8b49al8a323260041fcf1lf75a6f 


user 是 我 们 注册 的 名 字 , apikey 需要 去 JCenter 官网 查看 . 进入 修改 用 户 界面 , 点 击 左 侧 “API Key” 
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按钮 ， 然 后 输入 密码 就 能 看 到 了 ， 如 图 7-38 所 示 。 将 这 个 Key 复制 到 local.properties 中 进行 奉 换 。 


中 JFrog Bintray 















bsg Edit Your Profile 
anhul(hul) 









APIKey 











图 7-38 复制 APIKey 


(3 ) 使 用 gradle 命令 上 伟 
将 项 目 上 传 到 JCenter， 需 要 使 用 gradle 命令 。 首 先 将 gradle 加 入 环境 变量 。 在 Mac 系统 下 加 
入 环境 变量 的 方法 如 下 〈Windows 环境 不 会 加 入 环境 变量 的 可 以 自行 搜索 ) : 
http://blog.csdn.net/u013424496/article/details/52684213 
在 Android Studio 底部 有 一 个 “Terminal” 按 钮 (如 图 7-39 所 示 ) ， 点 击 后 进入 Terminal 页 面 。 
‘oo. OkHttpEncapsulation - OxHttpEncapsulation - [~/Documents/giy/github/OkHttpEncapsulation] 
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7-39 点击“Terminal” 按 钮 
在 Terminal 页 面 中 输入 以 下 命令 : 
gradle install 


出 现 BUILD SUCCESSFUL 就 表示 成 功 了 。 
继续 输入 命令 ， 提 交 项 目 到 bintray: 
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gradle clean build bintrayUpload 


这 个 命令 会 提示 上 传 进度 ， 上传 到 100% 就 表示 成 功 了 , 最 后 也 会 出 现 BUILD SUCCESSFUL 。 


(4) Addto JCenter 


提交 成 功 后 ,赶紧 打开 JCenter 官 网 ,查看 是 否 成 功 .在 首页 中 点 击 包 名 称 “okhttpencapsulation”， 


fi 项目 进入 详细 页 ， 如 图 7-40 所 示 。 





就 能 够 看 到 提交 的 项 目 ， 点 如 
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description yet. 
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我 们 可 以 看 到 版 本 、gradle 在 线 引 用 的 代码 ， 还 能 切换 到 Maven 和 lvy 方式 。 每 个 项 目 刚刚 提 
7-40 界面 右边 的 “Add to JCenter” 按 钮 进行 审核 。 审 核 成 功 后 仅 用 一 


交 都 必须 审核 ， 可 以 点 击 图 
行 代码 就 能 引用 这 个 模块 了 


图 7-40 项 目 上 传 成 功 





Android 5.X、6.X、7.X、8.X 各 版 本 特性 


本 章 学 习 Android 各 个 版 本 的 新 特性 ， 让 我 们 的 应 用 程序 能 够 兼容 不 同 的 Android 版 本 。 通 过 
5.0 版 本 的 更 新 内 容 学 习 新 的 Material Design 设计 风格 , 6.0 版 本 的 运行 时 添加 权限 可 防止 某 些 App 
在 后 台 盗 取 用 户 隐 私 ，7.0 版 本 的 多 窗口 支持 可 以 让 用 户 同时 处 理 多 个 任务 。 随 着 时 代 的 发 展 ， 手 
机 上 装 的 App 只 会 越 来 越 多 ，8.0 版 本 新 增 的 通知 渠道 功能 可 以 更 好 地 控制 通知 的 显示 。 

作为 一 名 软件 开发 人 员 ， 每 时 每 刻 学 习 是 立足 之 本 ， 不 停 掌握 新 技术 才能 避免 被 淘汰 。 本 章 
内 容 看 似 比较 少 ， 但 都 是 项 目 中 常用 的 技术 ， 和 希望 大 家 好 好 掌握 。 


8.1 Android 5.X 版 本 新 特性 


Android 5.0 是 谷歌 公司 2014 年 10 月 15 日 发 布 的 全 新 Android 系统 ， 从 Android 5.0 (Android 
Lollipop) 开始 ，Android 迎 来 了 扁平 化 时 代 ， 使 用 一 种 新 的 Material Design 设计 风格 ， 设 计 了 全 新 的 
通知 中 心 ， 开 始 支持 多 种 设备 。 在 性 能 上 ， 放 弃 了 之 前 一 直 使 用 的 Dalvik 虚拟 机 ， 改 用 ART 模式 ， 程 
序 加 载 时 间 大 幅 提 升 。 增 加 了 Battery Saver 模式 来 进行 省 电 处 理 ， 以 及 全 新 的 “最 近 应 用 程序 ”。 

提起 Android 5.0， 就 不 得 不 说 Material Design， 局 平 化 的 设计 理念 ， 新 的 视觉 语言 ， 在 基本 元 
素 的 处 理 上 ， 借 鉴 了 传统 的 印刷 设计 ， 比 如 字体 版 式 、 网 格 系统 、 空 间 、 比 例 、 配 色 、 图 像 使 用 等 
这 些 基 础 的 平面 设计 规范 。 

之 前 需要 自 定义 的 一 些 效果 ， 现 在 都 提供 了 系统 级 的 支持 ， 用 起 来 更 加 方便 ， 而 且 Android 
提供 的 效果 更 加 流畅 。 





8.1.1 悬挂 式 Notification 


Android 5.0 新 增 了 悬挂 式 Notification， 不 需要 下 拉 通 知 栏 就 能 直接 在 屏幕 上 方 悬挂 显示 ， 并 
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且 焦点 仍然 在 用 户 操作 的 界面 中 .因此 ,不 会 打 断 用 户 的 操作 , 过 几 秒 就 会 自动 消失 。 用 户 的 Activity 
处 于 全 屏 模式 中 ， 并 且 使 用 下 面 的 代码 让 Notification 变 为 悬挂 式 Notification: 


builder.setFul1ScreenIntent (pendingIntent, true); 





Android 5.0 中 Notification 分 成 了 三 个 等 级 : 


@ ” VISIBILITY_PRIVATE: 只 有 在 没有 锁 屏 时 才 会 显示 通知 。 
@ VISIBILITY_PUBLIC: 在 任何 情况 下 都 会 显示 通知 。 
@ VISIBILITY SECRET: 在 Pin、Password 等 安全 锁 和 没有 锁 的 情况 下 显示 通知 。 


使 用 时 改变 setVisibility 的 参数 即 可 : 


builder.setVisibility (Notification.VISIBILITY PUBLIC); 


另外 ， 从 5.0 开始 ， 对 于 通知 栏 图 标的 设计 进行 了 修改 。 现 在 Google 要 求 ， 所 有 应 用 程序 的 
通知 栏 图 标 应 该 只 使 用 Alpha 图 层 来 进行 绘制 ， 而 不 应 该 包括 RGB 图 层 。 只 使 用 Alpha 图 层 来 进 
行 绘制 ， 通 俗 点 讲 就 是 让 通知 栏 图 标 不 带 颜色 。 

第 7 章 我 们 已 经 学 习 了 通知 栏 的 使 用 ， 直 接 在 之 前 的 代码 上 进行 修改 ， 方 便 读 者 进行 对 比 。 
修改 后 代码 如 下 : 


NotificationCompat.Builder mBuilder = 
new NotificationCompat .Builder (this) 
.setsmallIcon (R.mipmap.ic launcher)// 小 图 标 
.SetContentTitle (" 悬 挂 式 通知 -标题 ") 
.setContentText (" 悬 挂 式 通知 -内 容 ") ; 
Intent intent=new Intent (this,NotificationActivity.class); 
PendingIntent ClickPending = PendingIntent.getRActivity(this，0，intent，0) 7 


mBuilder.setAutoCancel (true) ;// 点 击 这 条 通知 自动 从 通知 栏 中 取消 
mBuilder.setFullScreenIntent (ClickPending，true) ;// 显 示 悬 挂 式 通知 
NotificationManager mNotificationManager = 

(NotificationManager) getSystemService (Context .NOTIFICRATION SERVICE); 
mNotificationManager.notify(id, mBuilder.build()); 


在 之 前 的 代码 上 只 修改 了 一 行 代码 ， 即 将 setContentIntent 方法 换 成 了 setFullScreenIntent。 
运行 代码 ， 效 果 如 图 8-1 所 示 。 


EY Notfcations 


悬挂 式 通知 -标题 ， 现 在 
悬挂 式 通知 -内 容 





图 8-1 悬挂 式 通知 显示 
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有 些 定制 的 Android 系统 可 能 会 自动 屏蔽 应 用 的 悬浮 Notification 功能 ， 需 要 进行 设置 ， 在 
状态 栏 与 通知 中 修 并 p 允许 显示 通知 即 可 。 





8.1.2 利用 Drawerlayout 和 NavigationView 实现 侧 边栏 


DrawerLayout 是 SupportLibrary 包 中 实现 侧 滑 菜单 效果 的 控件 ,可 以 说 DrawerLayout 是 Google 
在 第 三 方 控件 (如 MenuDrawer、slidingmenu 等 ) 出 现 之 后 借鉴 来 的 产物 。 
DrawerLayout 分 为 侧 边 菜单 和 主 内 容 区 两 部 分 : 侧 边 菜 单 可 以 根据 手势 展开 与 隐藏 
(DrawerLayout 自身 特性 ) ， 主 内 容 区 的 内 容 可 以 随 着 菜单 的 点 击 而 变化 〈 这 需要 使 用 者 自己 实 
现 ) 。Google 的 很 多 App 都 使 用 这 种 侧 滑 菜单 ， 例 如 Google Play、Google Map、Contacts 等 。 因 
为 需要 用 到 NavigationView， 所 以 必须 引入 design 包 ， 这 里 我 们 使 用 在 线 依赖 方式 : 


compile 'com.android.support:design:25.3.0"' 


DrawerLayout 是 一 个 布局 控件 ， 与 LinearLayout 等 控件 一 样 ， 只 是 DrawerLayout 带 有 滑动 的 
功能 。 只 有 按照 DrawerLayout 规定 的 布局 方式 写 布 局 ， 才 能 产生 侧 滑 的 效果 。 
新 建 项 目 ， 修 改 activity_main.xml 文件 : 





<?xml Version="1.0" encoding="utf-8"?> 
<android.support .v4 .widget .DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<!-- 内 容 布 局 --> 

<include 
layout="@layout/layout sliding menu main" 
android:layout width="match parent" 
android:layout height="match parent" /> 


<android.support.design.widget.NavigationView 

android:id="e@+id/nav_ view" 

android:layout width="wrap_ content" 

android:layout height="match parent" 

android:layout gravity="start" 

android:fitsSystemWindows="true" 

app:headerLayout="@layout/layout sliding menu header" 

app:menu="@menu/sliding menu" /> 
</android.support.v4.widget .DrawerLayout> 


从 该 布局 中 可 以 看 出 ， 最 外 层 使 用 了 DrawerLayout， 主 内 容 区 域 通过 include 引入 一 个 布局 ， 
NavigationView 为 侧 边 抽 层 栏 。 
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主 内 容 区 的 布局 代码 要 放 在 侧 滑 菜单 布局 的 前 面 ， 可 以 帮助 DrawerLayout 判断 谁 是 侧 滑 菜 


单 、 谁 是 主 内 容 区 域 . 侧 滑 菜单 部 分 的 布局 (这 里 是 NavigationView ) 可 以 设置 layout_gravity 
属性 ， 表 示 侧 滑 菜 单位 于 左 侧 还 是 右 侧 。 





NavigationView 有 两 个 App 属性 ， 分 别 为 app:headerLayout 和 app:menu。 其 中 ，headerLayout 
用 于 显示 头 部 的 布局 〈 可 选 ) ，menu 用 于 建立 Menultem 选项 的 菜单 。 

NavigationView 控件 的 app:headerLayout 属性 引用 了 一 个 布局 文件 layout sliding menu_ 
header.xml， 布 局 结构 比较 简单 ， 最 外 层 使 用 LinearLayout， 里 面包 里 一 个 TextView， 源 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@color/colorAccent" 
android:orientation="horizontal" 
android:paddingBottom="80dp" 
android:paddingLeft="15dp" 
android:paddingRight="15dp" 
android:paddingTop="30dp"> 











<TextView 

android:layout width="wrap content" 
android:layout height rap content" 
android:layout gravity="center vertical" 
android:layout marginLeft="10dp" 
android:text=" 左 侧 菜 单 头 部 " 
android:textColor="#ffffffff"/> 

</LinearLayout> 








NavigationView 控件 的 app:menu 属性 引用 了 一 个 布局 文件 sliding_menu.xml， 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<group android:checkableBehavior="single"> 
<item 
android:id="@+id/nav camera" 





android:icon mipmap/ic launcher" 
android:title="Import"/> 
<item 


android:id="@+id/nav gallery" 





android:icon="@mipmap/ic launcher" 
android:title="Gallery"/> 
<item 


android:id="@+id/nav slideshow" 
android:icon="@mipmap/ic launcher" 
android:titl Slideshow"/> 
<item 

android:id="@+id/nav manage" 
android:icon="@mipmap/ic launcher" 
android:title="Tools"/> 

</group> 
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<item android:title="Communicate"> 


<menu> 
<item 


android: 


id="@+id/nav share" 


android:icon="@mipmap/ic launcher" 
android:title="Share"/> 


<item 


android:id="@+id/nav send" 
android:icon="@mipmap/ic launcher" 
android:title="Send"/> 


</menu> 
</item> 
</menu> 


menu 可 以 用 于 分 组 ,将 group 的 android:checkableBehavior 属性 设置 为 single 时 ， 可 以 设置 该 


组 为 单 选 。 


另外 ，include 的 首页 布局 文件 layout_sliding_menu_main.xml 里 面 也 是 包 庄 一 个 TextView， 内 


容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:1layout 
android:1layout 
android:1layout 
android:1layout 
android:1layout 


width="wrap content" 
height="wrap content" 
centerIinParent="true" 
gravity="center vertical" 
marginLeft="10dp" 


android:text=" 显 示 内 容 区 域 " 
android:textColor="@color/colorAccent" 


android:textSize="22sp" /> 


</RelativeLayout> 


不 需要 修改 任何 Java 代码 ， 
Android 开发 最 大 的 好 处 就 是 SDK 封装 得 很 好 ， 底 层 做 了 很 多 工 
作 。 运 行 代码 ， 效 果 如 图 8-2 所 示 。 

当 侧 滑 显示 左 侧 菜 单 栏 时 ， 


闭 侧 滑 菜单 栏 应 该 怎么 做 ? 


修改 MainActivityjava 文件 ， 在 onCreate 方法 中 查找 国 Tools 
NavigationView 控件 ， 并 且 设 置 item 点 击 监听 : 
NavigationView navigationView = (NavigationView) 


findViewById(R.id.nav view) 7 
navigationView.setNavigationItemSelectedListener 二 send 





(this); 


setNavigationJtemSelectedListener 方法 传 入 的 是 “this”， 所 
以 MainActivity 需要 实现 OnNavigationItemSelectedListener 接口 ， 


左 侧 菏 单 头 部 


通过 布局 文件 就 能 实现 侧 滑 功能 。 






画 。 mpon 


车 用 户 点 击 菜单 栏 的 item， 想 关 ed 


二 Sldeshow 


Communicate 


[ Share 


8-2 ” 侧 滑 功能 
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写 onNavigationItemSelected 方法 : 





@Override 
public boolean onNavigationItemSelected(@NonNull MenuItem item) { 


DrawerLayout drawer = (DrawerLayout) findViewById(R.id.drawer layout); 


// 关 闭 左 侧 菜单 栏 
drawer.closeDrawer (GravityCompat.START); 
return true; 


} 
这 个 方法 还 有 一 个 返回 参数 ， 是 一 个 布尔 类 型 : 值 为 true 时 ， 如 果 点 击 的 是 分 组 菜单 ， 
打开 时 就 会 有 一 个 选中 效果 ; 值 为 false 时 ， 下 次 打开 侧 滑 菜 单 没 有 选中 效果 。 


8.1.3 TabLayout 和 ViewPager 结合 使 用 


TabLayout 也 是 design 包 中 的 控件 ， 用 来 奉 代 第 三 方 开 源 项 目 TabPageIndicator。 
新 建 项 目 ， 首 先 修改 activity_main.xml 布局 文件 


<?xml version="1.0" encoding="utf-8"?> 
<android.support .design.widget .CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/coordinatorLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support .design.widget.AppBarLayout 
android:id="@+id/appBarLayout" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<android.support .v7 .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@color/colorAccent" 
app:layout scrollFlags="scrolllenterAlways"/> 


<android.support .design.widget.TabLayout 
android:id="@+id/tabLayout" 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal™ 
android:background="#54B0OE9" 
app:tabIndicatorColor="#ffffffff" 
app:tabIndicatorHeight="2dp" 
app:tabSelectedTextColor="#ffffffff" 
app:tabTextColor="#bebebe"/> 

</android.support.design.widget.AppBarLayout> 


<android.support .v4.view.ViewPager 
android:id="@+id/viewPager" 
android:layout width="match parent" 


下 次 
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android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior"/> 
</android.support.design.widget.CoordinatorLayout> 


最 外 层 是 CoordinatorLayout( 用 来 调度 协调 子 布局 ) ， 里 面 主 要 分 为 两 块 : AppBarLayout 和 
ViewPager。 其 中 , AppBarLayout 中 包含 标题 栏 的 Toolbar+TabLayout, ViewPager 用 来 切换 Fragment 
显示 。 

注意 : 为 了 使 得 Toolbar 具有 滑动 效果 ， 必 须 做 到 如 下 几 点 : 

(1) CoordinatorLayout 作为 布局 的 父 布局 容器 。 

(2) 给 需要 滑动 的 组 件 设置 app:layout_scrollFlags= "scrolllenterAlways" 属 性 。 
(3) 滑动 的 组 件 必须 是 AppBarLayout 顶部 组 件 。 

(4) 给 滑动 的 组 件 设置 app:layout_behavior 属性 。 

(5) ViewPager 显示 的 Fragment 中 不 能 是 ListView， 必 须 是 RecyclerView 。 


接 下 来 查看 MainActivity 代码 ， 和 之 前 ViewPager 的 写法 一 样 。 之 前 没有 学 习 过 的 就 是 调用 
TabLayout 的 setupWithViewPager 方法 将 TabLayout 和 ViewPager 关联 起 来 。 





Public class MainActivity extends AppCompatActivity { 
@Override 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


// 设 置 标题 内 容 以 及 标题 文字 颜色 

Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 

toolbar .setTitle ("关注 公众 号 [Android 开发 者 666] ")，; 
toolbar.setTitleTextColor (getResources () .getColor (android.R.color.white)); 


ViewPager vPager = (ViewPager) findViewById(R.id.viewPager); 
vPager .setOffscreenPageLimit (2) ;// 设 置 缓存 页 数 
vPager.setCurrentItem(0) ;// 设 置 当前 显示 的 item 0 表示 显示 第 一 个 


FragmentAdapter pagerAdapter = new 
FragmentAdapter (getSupportFragmentManager ()); 
FragmentTest fragmentOne=new FragmentTest (); 
FragmentTest fragmentTwo=new FragmentTest () 7 
FragmentTest fragmentThree=new FragmentTest (); 


// 把 Fragment 一 个 个 地 添加 到 适配器 中 ， 参 数 2 是 选项 卡 的 标题 
pagerAdapter.addFragment (fragmentOne, "选项 卡 1");// 
pagerAdapter.addFragment (fragmentTwo, "选项 卡 2"); 

pagerAdapter.addFragment (fragmentThree, "选项 卡 3") ; 


// 给 ViewPager 设置 适配器 
VPager .setAdapter (pagerAdapter); 


TabLayout tabLayout = (TabLayout) findViewById(R.id.tabLayout); 
// 通 过 TabLayout 的 setupWithViewPager 将 ViewPager 设置 进去 
tabLayout .setupWithViewPager (vPager); 
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上 面 的 代码 用 到 了 FragmentAdapter 类 ， 这 个 我 们 之 前 讲 ViewPager 时 用 到 过 ， 还 有 
FragmentTest 类 ， 其 中 包含 一 个 简单 的 RecyclerView 列表 。 有 不 懂 的 读者 ， 下 载 源码 进行 查看 就 明 
自 了 。 














8.1.4 CoordinatorLayout、 FloatingActionButton 和 Snackbar 的 使 用 


上 个 知识 点 学 习 了 CoordinatorLayout (协调 者 布局 ) ， 用 于 AppBarLayout 和 ViewPager 的 最 
外 层 布 局 ，ViewPager 上 下 滚动 时 会 让 AppBarLayout 隐藏 。 简 单 来 说 ，CoordinatorLayout 是 用 来 
协调 其 子 View 并 以 触摸 影响 布局 的 形式 产生 动画 效果 的 一 个 Super Powered FrameLayout， 其 典型 
的 子 View 包括 FloatingActionButton 和 Snackbar。 注 意 : CoordinatorLayout 是 一 个 顶级 父 View。 
1. FloatingActionButton 是 什么 


FloatingActionButton 实现 一 个 默认 颜色 为 主题 中 colorAccent 的 悬浮 操作 按钮 ， 继 承 自 
ImageButton， 可 以 使 用 android:src 属性 设置 圆 形 中 的 图 标 。 


2. Snackbar 是 什么 


Snackbar 是 一 个 操作 提供 轻 量 级 、 快 速 的 反馈 。Snackbar 可 以 在 屏幕 底部 快速 弹出 消息 ， 它 
和 Toast 非常 相似 ， 但 是 更 加 灵活 一 些 。Snackbar 显示 包含 了 文字 和 一 个 可 选 的 操作 按钮 ， 也 可 以 
设置 消失 时 间 。 
3. 实战 演习 
本 案例 是 在 上 个 案例 的 代码 基础 上 进行 添加 。 在 activity_mainxml 布局 文件 的 
CoordinatorLayout 控件 中 增加 如 下 控件 : 
<android.support.design.widget.FloatingActionButton 
android:id="@+id/fab" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="end|bottom" 


android:layout margin="15dp" 
android:src="@mipmap/ic launcher"/> 

















在 MainActivity 中 给 FloatingActionButton 设置 点 击 事件 , 弹出 Snackbar, 其 写法 和 Toast 的 写 
法 相似 。 


Snackbar .make (View，" 这 是 内 容 "， Snackbar.LENGTH SHORT) .setAction 
(" 取 消 "，new View.OnClickListener() { 
@Override 
Public void onClick(View view) { 
Toast.makeText (MainActivity.this, 
"cancel",Toast .LENGTH SHORT) .show(); 

} 

}) .show(); 


最 终 效 果 如 图 8-3 所 示 。 
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图 8-3 效果 图 


8.2 ”Android 6.X 版 本 新 特性 


Android 6.0 (Android Marshmallow) 最 大 的 亮点 是 为 用 户 提供 了 两 套 相 互 独立 的 解决 方案 ， 
简单 地 说 ， 就 是 为 每 位 用 户 的 每 一 个 应 用 提供 了 两 套数 据 存储 方案 。 一 套 存储 工作 资料 ， 另 一 套 存 
储 个 人 信息 。 另 外 ，Android M 系统 层面 加 入 指纹 识别 , 还 加 入 了 运行 时 权限 , 加 入 了 App Standby 
(应 用 待机 ) 、Doze( 睛 睡 ) Exemptions〔 共 免 ) 等 模式 来 加 强 电源 管理 。 


8.2.1 6.0 运行 时 权限 


从 Android 6.0 (API 级 别 23) 开始 ， 有 些 权 限 只 有 用 户 在 使 用 软件 时 才 向 其 授予 权限 ， 而 
不 是 在 安装 时 授权 。 这 种 方法 可 以 简化 安装 过 程 , 用户 在 安装 或 者 更 新 软件 时 不 需要 授予 权限 。 它 
还 能 够 让 用 户 对 应 用 的 某 些 功 能 进行 控制 。 例 如 ， 单 机 版 的 斗 地 主 ， 请 求 访问 任何 权限 ， 我 都 会 拒绝 。 
当然 你 也 可 以 在 设置 界面 对 每 个 App 的 权限 进行 查看 ， 以 及 对 单个 权限 进行 授权 或 者 解除 授权 。 
1. 系统 权限 分 为 两 类 : 正常 权限 和 危险 权限 
@@ 正常 权限 不 会 直接 给 用 户 隐私 权 带 来 风险 ， 在 AndroidManifestxml 中 注册 即 可 。 
危险 权限 会 授予 应 用 访问 用 户 机 密 数据 的 权限 。 在 AndroidManifest.xml 中 注册 了 危险 权限 ， 
同时 需要 用 户 授 权 你 的 软件 才能 使 用 这 个 权限 。 


哪些 属于 正常 权限 ， 哪 些 属于 危险 权限 ， 大 家 可 以 去 官网 阅读 。 


https://developer.android.com/guide/topics/security/permissions.html#norma 
l-dangerous 
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2. 简单 的 例子 (6.0 手机 获取 危险 权限 ) 
如 果 App 需要 一 个 调用 拨打 电话 的 功能 ， 这 时 就 需要 获取 CALL_PHONE 权限 。 我 们 来 看 看 
在 6.0 的 手机 上 拨打 电话 代码 需要 怎么 写 : 


Public class MainActivity extends AppCompatActivity implements 
View.OnClickListener { 
private String[] perms = {Manifest.permission.CALL PHONE}; 
private final int PERMS REQUEST CODE = 200; 


@Override 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


findViewById(R.id.btn call phone) .setOnClickListener (this); 
) 


@Override 
Public void onClick(View v) { 
if (v.getId() == R.id.btn call phone) {// 获 取 拨打 电话 的 权限 
if (Build.VERSION.SDK INT > Build.VERSION CODES .LOLLIPOP MR1) { 
//android 6.0 以 上 版 本 需要 获取 权限 
requestPermissions (Perms, PERMS REQUEST CODE) ;// 请 求 权限 
} else { 
callPhone (); 
} 


F 


/** 
获取 权限 回调 方法 
* @param permsRequestCode 
* @param permissions 
* @param grantResults 
of 
@Override 
Public void onRequestPermissionsResult (int permsRequestCode, String[] 
permissions, int[] grantResults) { 
switch (permsRequestCode) { 
Case PERMS REQUEST CODE: 
boolean storageAccepted = grantResults[0] == 
PackageManager .PERMISSION GRANTED; 
if (storageAccepted) { 
callPhone(); 
yslse 


Log.i("MainActivity"，" 没 有 权限 操作 这 个 请 求 ") ; 


+* 


break; 
} 
// 拨 打 电 话 


Private void callPhone() { 
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// 检 查 拨打 电话 权限 
if (ActivityCompat.checkSelfPermission(this, 
Manifest.permission.CALL PHONE) == PackageManager .PERMISSION GRANTED) { 


Intent intent = new Intent(Intent.ACTION CALL); 
intent.setData (Uri.parse ("tel:" + "10086")); 
startActivity (intent); 


} 


获取 权限 之 前 先 判断 版 本 号 ， 版 本 大 于 6.0， 就 调用 requestPermissions 方法 请 求 权限 。 这 个 方 
法 有 两 个 参数 :参数 1 是 要 请 求 的 权限 数组 ， 一 次 可 以 请 求 多 个 权限 ; 参数 2 是 一 个 int 类 型 的 请 
求 标示 。 不 管用 户 同 意 还 是 拒绝 都 会 回调 onRequestPermissionsResult 方法 。 这 个 方法 的 
permsRequestCode 参数 就 是 我 们 请 求 时 的 第 二 个 参数 ， 然 后 判断 permsRequestCode 数组 的 第 一 个 
参数 。 值 等 于 PackageManager.PERMISSION_GRANTED 时 表示 用 户 同意 授权 ， 否则 用 户 拒绝 授权 
这 个 权限 。 

3. 获取 特殊 权限 


Android 特殊 权限 只 有 两 种 ， 即 SYSTEM_ALERT_WINDOW 和 WRITE_SETTINGS， 与 正常 
权限 和 人 危险 权限 不 同 。 特殊 权限 比较 敏感 ， 因此 大 多 数 应 用 不 应 该 使 用 它们 。 如 果 某 个 应 用 需要 其 
中 一 种 权限 ， 必 须 在 清单 中 声明 该 权限 ， 并 且 发 送 请 求 用 户 授权 的 Intent。 系 统 将 向 用 户 显示 详细 
管理 屏幕 ， 以 响应 该 Intent。 

首先 判断 Android 版 本 号 是 不 是 大 于 6.0， 通 过 Settings.canDrawOverlays 判断 有 没有 系统 弹 窗 
权限 。 如 果 没 有 权限 ， 则 发 送 一 个 intent 请 求 授权 。 

if (Build.VERSION.SDK INT > Build.VERSION CODES.LOLLIPOP MR1){ 

if (Settings .canDrawOver1lays (this)) { 
systemAlert () 
} else {// 没 有 系统 弹 窗 权限 , 发送 一 个 设置 权限 的 intent 
Intent intent = new Intent (Settings .ACTION MANAGE OVERLAY PERMISSION); 


intent .setData(Uri.parse("package:" + getPackageName () ) ); 
startActivityForResult (intent, PERMS REQUEST CODE) 








onActivityResult 方法 ， 授 权 失 败 或 者 成 功 都 会 回调 这 个 方法 。 在 这 里 可 以 判断 用 户 同意 


Qoverride 
Protected void onActivityResult (int requestCode, int resultCode, Intent data) 


if (requestCode == PERMS REQUEST CODE) { 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.M) { 
//Android M 处 理 Runtime Permission 

if (Settings.canDrawOverlays (this)){// 有 系统 弹 窗 权限 
Log.i ("MainActivity", "获取 系统 弹 窗 (特殊 权限 ) 成功") ; 
systemAlert (); 

} else { 
Log.i("MainActivity", "拒绝 系统 弹 窗 (特殊 权限 ) ") ; 

i 
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} 


4. 申请 这 么 多 权限 岂 不 是 很 累 

其 实 不 需要 每 个 权限 都 去 申请 ， 举 一 个 例子 ， 如 果 你 的 应 用 授权 了 读 取 联系 人 的 权限 ， 那 么 
该 应 用 也 是 被 赋予 了 写 入 联系 人 的 权限 。 因 为 读 取 联 系 人 和 写 入 联系 人 这 两 个 权限 都 属于 联系 人 权 
限 分 组 ， 所 以 一 旦 组 内 某 个 权限 被 允许 ， 该 组 的 其 他 权限 也 是 被 允许 的 。 





虽然 在 代码 中 请 求 了 运行 时 权限 ， 但 是 在 Manifest.xml 文件 中 也 要 注册 权限 。 


<uses-permission android:name="android.permission.CALL _ PHONE"/> 
<uses-permission android:name="android.permission.SYSTEM ALERT WINDOW"/> 


最 后 运行 代码 ， 请 求 打 电 话 的 权限 授权 弹 窗 如 图 8-4 所 示 ， 请求 特殊 权限 授权 界面 如 图 8-5 所 





示 。 


可 
立 ”privilegeManagement OO 


允许 在 其 他 应 用 的 上 层 显示 


\ 


PrivilegeManagement 








图 84 请 求 打 电话 权限 图 8-5 请 求 特殊 权限 


8.3 Android 7.X 版 本 新 特性 


Android 7.0 (Android Nougat) 在 性 能 处 理 上 有 了 巨大 的 提升 ， 同 时 对 文件 数据 加 密 ， 更 加 安 
全 。 添 加 了 分 屏 多 任务 ， 重 新 设计 了 通知 ， 改 进 Doze 休眠 机 制 等 。 总 而 言 之 ，Android N 将 更 快 、 
更 好 、 更 强 。 
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8.3.1 多 窗口 支持 


Android 7.X 可 以 同时 显示 多 个 应 用 窗口 。 在 手机 上 ， 两 个 应 用 
可 以 在 “分 屏 ” 模 式 中 左右 并 排 或 上 下 并 排 显 示 。 例如， 用 户 可 以 在 
上 面 窗口 聊 QQ， 下 面 窗口 发 送 短 信 。 

如 图 8-6 所 示 ， 两 个 App 在 分 屏 模式 中 上 下 并 排 显示 。 

1. 让 App 支持 多 窗口 

如 果 您 的 App 支持 Android N, 只 要 在 AndroidManifest.xml 文件 


中 对 <activity> 或 <application> 标 签 设置 android:resizeableActivity 属 
性 就 能 启用 或 者 禁用 多 窗口 显示 : 

android:resizeableActivity=["true" | "false"] 

如 果 这 个 属性 的 值 为 true, 则 Activity 能 够 分 屏 和 自由 模式 启动 ; 
如 果 这 个 属性 的 值 为 false， 则 Activity 不 支持 多 窗口 模式 。 

如 果 App 支持 Android N， 但 是 没有 对 该 属性 设置 值 ， 则 该 属性 
的 默认 值 为 true， 也 就 是 默认 支持 多 窗口 模式 。 

2. 切换 到 多 窗口 模式 





MultiWindow 


日 


图 8-6 分 屏 显 示 


@ ”车 用 户 打开 OverView 屏幕 并 长 按 Activity 标题 ， 则 可 以 拖 动 该 Activity 到 屏幕 突出 显示 的 区 


域 ， 使 Activity 进入 多 窗口 模式 。 


@ 若 用 户 长 按 OverView 按钮 ,设备 上 的 当前 Activity 将 进入 多 窗口 模式 ,同时 将 打开 OverView 


屏幕 ， 用 户 可 以 在 该 屏幕 中 选择 要 共享 屏幕 的 另 一 个 Activity。 
3. 多 窗口 的 生命 周期 
多 窗口 模式 不 会 更 改 Activity 的 生命 周期 。 


在 多 窗口 模式 中 ， 指 定时 间 内 只 有 最 近 与 用 户 交 互 过 的 Activity 为 活动 状态 。 该 Activity 将 被 
视 为 顶级 Activity。 所 有 其 他 Activity 虽然 可 见 ， 但 是 均 处 于 暂停 状态 。 不 过 ， 这 些 已 暂停 但 可 见 
的 Activity 在 系统 中 享有 比 不 可 见 Activity 更 高 的 优先 级 。 如 果 用 户 与 其 中 一 个 暂停 的 Activity 交 


互 ， 该 Activity 将 恢复 ， 而 之 前 的 顶级 Activity 将 暂停 。 
4. 多 窗口 模式 下 的 布局 属性 


对 于 Android N， 可 以 在 activity 标签 中 设置 标签 。 标 签 支 持 以 下 几 种 属性 ， 这 些 属性 将 影响 


Activity 在 多 窗口 模式 中 的 效果 : 
e@ ”android:defaultWidth: 多 窗口 模式 下 的 默认 宽度 。 
ee android:defaultHeight: 多 窗口 模式 下 的 默认 高 度 。 
@ android:gravity: 多 窗口 模式 下 的 初始 位 置 。 


e android:minimalHeight、android:minimalWidth: 多 窗口 模式 下 的 最 小 高 度 和 最 小 宽度 。 如果 用 
户 在 分 屏 模式 中 移动 分 界线 , 使 Activity 尺寸 低 于 指定 的 最 小 值 , 系统 会 将 Activity 裁剪 为 用 


户 请 求 的 尺寸 。 
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例如 ， 以 下 配置 如 何 指定 在 多 窗口 模式 中 显示 时 Activity 的 默认 大 小 、 位 置 和 最 小 尺寸: 


<activity android:name=".MyActivity"> 
<layout android:defaultHeight="500dp" 
android:defaultWidth="600dp" 
android:gravity="toplend" 
android:minimalHeight="450dp" 
android:minimalWidth="300dp" /> 
</activity> 


5. 多 窗口 变更 通知 和 查询 

Activity 类 中 添加 了 以 下 新 方法 ， 以 支持 多 窗口 显示 。 

® ActivityisInMultiWindowMode0: 判断 是 否 处 于 多 窗口 模式 。 

e Activity.onMultiWindowModeChanged(): 进入 或 退出 多 窗口 模式 时 会 回调 这 个 方法 。 

其 实 ， 多 窗口 在 工作 中 应 该 使 用 的 机 会 不 大 ， 毕 竞 手机 屏幕 比较 小 ， 分 屏 都 看 不 到 什么 界面 
了 。 不 过 ， 作 为 开发 者 有 必要 去 了 解 一 下 Android 7.0 更 新 了 哪些 功能 。 


8.3.2 ”FileProvider 解决 FileUriExposedException 


1. 了 解 FileUriExposedException 
在 给 App 进行 版 本 升级 时 ， 先 从 服务 器 下 载 新 版 本 的 APK 文件 到 SD 卡 的 路 径 中 ， 然 后 调用 
安装 APK 的 代码 ， 一 般 写法 如 下 : 
Private void openRPK (String fileSavePath){ 
File file=new File(fileSavePath) 7 
Intent intent = new Intent (Intent.RACTION VIEW) ; 
Uri data = Uri.fromFile (file); 
intent.setDataAndType (data, "application/vnd.android.package-archive"); 


startActivity (intent); 
} 


这 样 的 写法 在 Android 7.0 之 前 的 版 本 没有 任何 问题 , 只 要 给 定 一 个 APK 文件 路 径 就 能 打开 安 
装 ， 但 是 在 Android 7.0 版 本 上 会 报错 : 


android.os.FileUriExposedException: 
file:///storage/emulated/0/Download/FileProvider.apk 
exposed beyond app through Intent .getData() 


从 Android 7.0 开始 ， 一 个 应 用 提供 自身 文件 给 其 他 应 用 使 用 时 ， 如 果 给 出 一 个 file:// 格 式 的 
URI 的 话 , 应 用 会 抛 出 FileUriExposedException。 这 是 由 于 谷歌 认为 目标 App 可 能 不 具备 文件 权限 ， 
会 造成 潜在 的 问题 ， 因 此 让 这 个 行为 快速 失败 。 

2. FileProvider 方式 解决 

这 是 谷歌 官方 推荐 的 解决 方案 ， 即 使 用 FileProvider 来 生成 一 个 content:// 格 式 的 URI。 

(1 ) 在 Manifestxml 中 声明 一 个 provider 


<application "> 
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<Provider 
android:name="android.support.v4.content.FileProvider" 
:authorities="com.ansen.fileprovider.fileprovider" 
:grantUriPermissions="true" 
android:exported="false"> 
<meta-data 
android:name="android.support.FILE PROVIDER PATHS" 
android:resource="@xml/file paths" /> 
</provider> 
</application> 


android:name 值 是 固定 的 ，android:authorities 随便 写 但 是 必须 保证 唯一 性 ， 这 里 用 的 是 包 名 
+"fileprovider"，android:grantUriPermissions 和 android:exported 是 固定 值 。 

其 中 包含 一 个 meta-data 标签 ， 这 个 标签 的 name 属性 固定 写法 ，android:resource 对 应 的 是 一 
个 xml 文件 。 在 res 文件 夹 下 新 建 一 个 xml 文件 夹 ， 再 在 xml 文件 夹 下 新 建 file_paths.xml 文件 。 
内 容 如 下 : 

<?xml Version="1.0" encoding="utf-8"?> 

<paths> 


<external-path name="name" path="Download"/> 
</paths> 


name 表示 生成 Uri 时 的 别名 ，path 是 指 相 对 路 径 。 
paths 标签 下 的 子 元 素 一 共有 以 下 几 种 : 


files-path 对 应 ”Context.getFilesDir() 

cache-path 对 应 ”Context.getCacheDir () 

external-path 对 应 Environment .getExternalStorageDirectory() 
external-files-path 对 应 Context.getExternalFilesDir() 
external-cache-path 对 应 Context.getExternalCacheDir() 


(2) 修改 后 打开 Apk 文件 的 代码 
首先 判断 一 下 版 本 号 ,如 果 手 机 操作 系统 版 本 号 大 于 等 于 7.0, 就 通过 FileProvider.getUriForFile 
方法 生成 一 个 Uri 对 象 。 


Private void openAPK (String fileSavePath){ 

File file=new File(fileSavePath); 

Intent intent = new Intent (Intent.ACTION VIEW); 

Uri data; 

if (Build.VERSION.SDK INT >= Build.VERSION CODES.N) {// 判 断 版 本 大 于 等 于 7.0 
//"com.ansen.fileprovider.fileprovider" 即 是 在 清单 文件 中 配置 的 authorities 
// 通过 FileProvider 创建 一 个 content 类 型 的 Uri 
data = FileProvider.getUriForFilel(this, 

"com.ansen.fileprovider .fileprovider", file); 
intent.addFlags (Intent .FLAG GRANT READ URI PERMISSION); 
// 给 目标 应 用 一 个 临时 授权 





} else { 
data = Uri.fromFile (file); 
} 
intent.setDataAndType (data, "application/vnd.android.package-archive"); 
startActivity (intent); 
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8.4 _ Android 8.X 版 本 新 特性 


Android 8.0 (Android Oreo) 是 Google 发 布 的 第 14 个 新 系统 版 本 ， 在 功能 、 流 畅 、 安 全 上 都 
不 落下 风 ， 对 通知 又 进行 了 改变 ， 增 加 了 通知 渠道 。 同 时 对 静态 广播 的 使 用 也 做 了 一 些 限制 。 


8.4.1 ”通知 栏 新 增 通知 渠道 


从 Android 8.0 (API 级 别 26) 开始 ， 所 有 通知 必须 要 分 配 一 个 渠道 ， 对 于 每 个 渠道 ， 可 以 单 
独 设置 视觉 和 听觉 行为 ， 然 后 用 户 可 以 在 设置 中 进行 修改 , 根据 应 用 程序 来 决定 哪些 通知 可 以 显示 
或 者 隐藏 。 

创建 通知 渠道 之 后 ， 程 序 无 法 修改 通知 行为 。 只 有 用 户 可 以 修改 ， 程 序 只 能 修改 渠道 名 称 和 

我 们 可 以 为 一 个 应 用 程序 创建 多 个 通知 渠道 ， 不 同 的 通知 类 型 使 用 不 同 的 渠道 。 例 如 ， 重 要 
通知 用 一 个 渠道 ,可 以 将 这 个 渠道 重要 性 设置 成 最 高 ; 不 怎么 重要 的 通知 使 用 一 个 渠道 ,这 个 渠道 
重要 性 设置 成 最 低 。 

1. 创建 一 个 通知 

要 创建 一 个 通知 ， 有 以 下 几 个 步骤 : 

步骤 01 构造 NotificationChannel 对 象 ， 构 造 方法 有 三 个 参数 ;渠道 it、 渠道 名 称 、 渠 道 重 
要 性 级 别 。 

步骤 02Q 调用 NotificationChannel.setDescription 方法 可 以 设置 渠道 描述 。 这 个 描述 在 系统 设 
置 中 可 以 看 到 。 

步骤 034 调用 NotificationManager.createNotificationChannel 方法 创建 通知 渠道 。 


以 下 是 注册 通知 渠道 的 代码 ， 记 得 先 判 断 版 本 号 是 不 是 大 于 或 者 等 于 8.0， 因 为 只 有 8.0 以 上 
才 有 通知 渠道 API。 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.0) { 
// 创 建 通知 渠道 
CharSequence name = "渠道 名 称 1"; 
String description = "渠道 描述 1"; 
String channelId="channelId1";// 渠 道 id 
int importance = NotificationManager .IMPORTANCE DEFAULT;// 重 要 性 级 别 
NotificationChannel mChannel = new NotificationChannel (channelId, name, 
importance); 
mChannel.setDescription (description) ;// 渠 道 描述 
mChannel .enableLights (true) ;// 是 否 显示 通知 指示 灯 
mChannel .enableVibration (true) ;// 是 否 振动 








NotificationManager notificationManager = (NotificationManager) 
getSystemService (NOTIFICATION SERVICE); 
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notificationManager.createNotificationChannel (mChannel) ;// 创 建 通知 渠道 
} 
创建 通知 渠道 不 会 执行 任何 操作 ， 所 以 在 启动 应 用 程序 时 最 好 调用 以 上 代码 。 
执行 以 上 代码 ， 就 能 够 在 “应 用 通知 ” “设置 ”一 “应 用 和 通知 ”一 “选择 当前 App” 一 
“应 用 通知 ”) 界面 中 看 到 创建 的 通知 渠道 ， 如 图 8-7 所 示 。 可 以 单独 开关 当前 的 通知 类 别 ， 还 可 
以 点 击 当前 渠道 ， 进 入 渠道 详细 界面 ， 如 图 8-8 所 示 。 在 渠道 详细 界面 中 可 以 设置 渠道 的 提示 音 、 
振动 、 屏 幕 锁定 时 显示 方式 等 。 








《应 用 通知 


@ enfcatons 


开启 


多 许 使 用 通知 图 点 


要 江 名 本 1 


局 Ry 


号 示 通知 国 点 


和 人 听 扩 宙 





图 8-7 单个 App 通知 所 有 渠道 列表 图 8-8 渠道 详细 界面 


默认 情况 下 ， 通 知 的 振动 和 声音 提示 都 是 由 NotificationManagerCompat 类 中 重要 性 级 别 决 定 
的 ， 例 如 常量 IMPORTANCE_DEFAULT 和 IMPORTANCE_HIGH， 后 面 会 讲 到 这 些 常 量 的 具体 作 
用 。 

如 果 想 改变 该 渠道 的 默认 通知 ， 可 以 调用 NotificationChannel 对 象 的 方法 进行 修改 。 下 面 介绍 
几 个 常用 的 方法 。 

@ enableLights(): 是 否 显示 通知 指示 灯 。 

@ setLightColor0: 设置 通知 灯 颜 色 。 

@ setVibrationPattern(): 设置 振动 模式 。 





上 面 那 段 代 码 只 告诉 了 创建 渠道 ， 下 面 这 段 代 码 让 我 们 在 之 前 创建 的 渠道 上 发 送 一 个 通知 。 
// 第 二 个 参数 与 channelId 对 应 


Notification.Builder builder = new Notification.Builder (this,channelId)， 
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//icon title text 必须 包含 ， 不 然 影响 桌面 图 标 小 红 点 的 展示 
builder.setSmallIcon (android.R.drawable.stat notify chat) 
.setContentTitle ("通知 渠道 1-> 标 题 ") 
.setContentText ("通知 渠道 1-> 内 容 ") 
.setNumber (3) ; // 久 按 桌 面 图 标 时 允许 的 此 条 通知 的 数量 


Intent intent=new Intent (this,NotificationActivity.class); 
PendingIntent ClickPending = PendingIntent.getActivity(this, 0, intent, 0); 
builder.setContentIntent (ClickPending); 


notificationManager.notify(id,builder.build()); 

使 用 Notification.Builder 构造 通知 对 象 时 , 传 入 第 二 个 参数 就 是 渠道 id, 用 这 个 渠道 id 就 能 与 
之 前 创建 的 渠道 进行 关联 。 设 置 内 容 和 发 送 系 统 通知 代码 与 之 前 类 似 。 运 行 以 上 代码 ， 就 能 在 8.0 
的 手机 上 显示 通知 了 。 

2. 设置 渠道 重要 性 级 别 

渠道 重要 性 级 别 影响 该 渠道 中 所 有 通知 的 显示 , 在 创建 NotificationChannel 对 象 的 构造 方法 中 
必须 要 指定 级 别 ,一 共有 5 个 重要 性 级 别 , 即 IMPORTANCE_NONE(0) 至 IMPORTANCE_HIGH(4)， 
如 表 8-1 所 示 。 





表 8-1 渠道 重要 性 级 别 


用 户 可 见 的 重要 性 级 别 重要 性 (Android 8.0 及 更 高 版 本 ) 
紧急 发 出 声音 并 显示 为 提醒 通知 ) 
高 (发 出 声音 ) 


中 等 (没有 声音 ) IMPORTANCE LOW 
低 (无 声音 并 且 不 会 出 现在 状态 栏 中 ) 


3. 根据 渠道 id 查看 渠道 信息 
我 们 都 知道 渠道 创建 之 后 不 能 通过 代码 修改 ， 但 是 可 以 先 查 看 该 渠道 的 振动 和 声音 等 行为 ， 
如 果 需 要 修改 ， 可 以 根据 返回 的 内 容 再 提示 用 户 手 动 去 打开 。 





( 1 ) 调用 NotificationManagergetNotificationChannel(String channelld) 方 法 获取 
NotificationChannel 对 象 ， 这 个 方法 有 个 参数 渠道 id。 
(2) 有 了 NotificationChannel 对 象 就 能 调用 getVibrationPattern 、getSound、getImportance 等 
方法 。 
示例 代码 如 下 所 示 : 
NotificationChannel 
notificationChannel=notificationManager.getNotificationChannel (channelId); 
long[] vibrationpattern=notificationChannel.getVibrationPattern();// 振 动 模式 
if(vibrationPattern!=nul1)1{ 
Log.i("ansen"v "振动 模式 :"+vibrationPattern.length) 
1 


Uri uri=notificationChannel.getSound();// 通 知 声 音 
Log.i("ansen", "通知 声音 :"+uri. toString()) 7 
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int importance=notificationChannel1.getImportance () ;// 通 知 等 级 

Log .i ("ansen", "通知 等 级 : "+importance) ; 

4. 打开 通知 渠道 设置 界面 

创建 通知 渠道 之 后 ， 代 码 无 法 修改 这 个 渠道 的 行为 ， 只 有 用 户 在 设置 中 才能 进行 修改 〈 设 置 > 
应 用 和 通知 > 要 修改 的 App)。 为 了 让 用 户 更 快 地 找到 当前 App 的 通知 渠道 , 可 以 通过 代码 发 送 Intent 
打开 通知 渠道 的 设置 界面 。 

以 下 代码 是 打开 通知 渠道 的 设置 界面 : 

Intent channelIntent = new 
Intent (Settings.ACTION CHANNEL NOTIFICATION SETTINGS); 

channelIntent .putExtra(Settings.EXTRA APP PACKAGE, getPackageName () ) ; 

channelIntent .putExtra(Settings.EXTRA CHANNEL ID,channelId); 

// 渠 道 id 必须 是 我 们 之 前 注册 的 


startActivity(channelIntent); 

需要 传 入 两 个 参数 ， 应 用 程序 的 包 名 和 渠道 id。 

5. 删除 通知 渠道 

调用 deleteNotificationChannel(String channelId) 方 法 删除 渠道 ， 代 码 如 下 : 


NotificationManager mNotificationManager = 
(NotificationManager) getSystemService (Context .NOTIFICATION SERVICE); 
mNotificationManager.deleteNotificationChannel (channelId); 


6. 8.0 通知 栏 点 击 通知 发 送 广播 

在 前 面 的 案例 中 ,我 们 点 击 通知 栏 都 是 跳 转 到 指定 Activity, 但 是 PendingIntent 除了 getActivity 
方法 之 外 ， 还 有 getBroadcast 跟 getService。 可 以 点 击 通知 发 送 广播 ， 开 启 Service。 

于 是 我 们 修改 显示 通知 的 代码 : 


String BROADCAST ACTION="android.intent.action.BROADCAST ACTION"; 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.0) { 
// 第 二 个 参数 与 channelId 对 应 
Notification.Builder builder = new Notification.Builder (this,channelId) 
//icon title text 必须 包含 ， 不 然 影响 桌面 图 标 小 红 点 的 展示 
builder.setSmallIcon (android.R.drawable.stat notify chat) 
.setContentTitle ("通知 渠道 1-> 标 题 ") 
.setContentText (" 通 知 渠 道 1-> 内 容 ") 
.setNumber (3) ; // 长 按 桌 面 图 标 时 允许 的 此 条 通知 的 数量 


Intent intent = new Intent (BROADCAST ACTION); 

intent.putExtra("data", "12345");// 带 上 参数 

PendingIntent PendingIntent=PendingIntent .getBroadcast (this,id, intent, 
PendingIntent .FLAG UPDATE CURRENT); 

builder.setContentIntent (pendingIntent); 

builder.setAutoCancel (true); 


mNotificationManager.notify(id,builder.build()); 
} 


新 建 Intent 对 象 的 时 候 就 传 入 了 一 个 action， 同 时 给 Intent 传 入 一 个 字符 串 参 数 ， 然 后 调用 
PendingIntent.getBroadcast 构造 PendingIntent 对 象 ， 最 后 调用 notify 方法 显示 通知 。 
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新 建 一 个 类 DynamicBroadcast， 继 承 BroadcastReceiver， 用 来 接收 通知 栏 点 击 时 发 送 的 广播 。 
在 onReceive 方法 中 打印 一 下 我 们 传 入 的 参数 。 
Public class DynamicBroadcast extends BroadcastReceiver { 
@Override 
public void onReceive (Context context, Intent intent){ 


String data = intent.getStringExtra("data"); 
Log.i("data",data); 


} 


前 面 的 内 容 我 们 讲 了 广播 的 两 种 注册 方式 ， 静 态 注册 跟 动 态 注 册 ， 这 里 我 们 使 用 静态 注册 。 
在 AndroidManifestxml 文件 application 标签 中 增加 如 下 代码 : 

<receiver android:name=" .DynamicBroadcast" 

android:exported="true"> 
<intent-filter> 

<action android:name="android.intent.action.BROADCAST ACTION" /> 
</intent-filter> 

</receiver> 

运行 之 后 发 现在 Android 8.0 版 本 以 下 的 手机 正常 ， 点 击 通知 栏 会 打印 广播 的 日 志 ， 但 是 在 
Android 8.0 版 本 或 以 上 版 本 点 击 通知 栏 发 现 没 有 收 到 广播 ， 我 以 为 是 8.0 增加 了 通知 渠道 的 问题 ， 
后 面 查看 官网 API， 在 Broadcasts 类 下 面 看 到 了 这 和 句 话 : 

Beginning with Android 8.0 (API level 26), the system imposes additional 
restrictions on manifest-declared receivers. If your apP targets API level 26 or 
higher, you cannot use the manifest to declare a receiver for most implicit broadcasts 
(broadcasts that do not target your app specifically). 

大 概 意思 是 从 Android 8.0(API 级 别 26) 开始 , 无 法 在 AndroidManifest.xml 文件 中 声明 隐 式 广 
播 ， 系 统 的 隐 式 广播 正常 使 用 。 所 以 ， 如 果 你 的 手机 是 Android 8.0 以 上 版 本 的 ， 就 需要 动态 注册 
广播 ， 这 样 才 能 接收 到 通知 栏 点 击 时 发 送 的 广播 。 

注释 掉 AndroidManifestxml 文件 中 声明 的 广播 ， 然 后 在 MainActivity 的 onCreate 方法 中 注册 
广播 ， 代 码 如 下 : 

// 动 态 注册 广播 

dynamicBroadcast=new DynamicBroadcast (); 


IntentFilter intentFilter=new IntentFilter (BROADCAST ACTION); 
registerReceiver (dynamicBroadcast, intentFilter); 


静态 注册 的 广播 一 定 要 在 onDestroy 方法 中 取消 注册 : 


Qoverride 
Protected void onDestroy() { 
Super .onDestroy () 7 


if(dynamicBroadcast!=null1){ 
unregisterReceiver (dynamicBroadcast) ;// 取 消 注册 广播 


第 9 章 


常用 功能 模板 


本 章 主要 学 习 几 个 常用 的 功能 模块 ， 通 过 这 些 模 块 串联 之 前 所 学 的 知识 点 ， 让 读者 知道 一 些 
知识 点 用 在 哪 种 需求 或 者 界面 中 比较 合适 ， 对 之 前 所 学 的 知识 点 进行 巩固 和 复习 。 

例如 ， 检 查 更 新 下 载 安装 案例 用 到 了 之 前 学 到 的 网 络 请 求 、 文 件 保存 SD 卡 、ProgressDialog 
(对 话 框 进度 条 ) 、OkHttp 网 络 框架 等 技术 。 

另外 ， 有 关 微 信 分 享 和 百度 地 图 的 使 用 ， 让 读者 学 习 如 何 接 入 SDK 去 封装 别人 的 SDK。 通 过 
引导 页 和 Banner 广告 轮 播 图 案例 ， 让 读者 更 加 熟练 地 使 用 ViewPager。 


9.1 ”启动 页 与 首次 启动 的 引导 页 


启动 页 与 引导 页 是 每 个 App 都 有 的 功能 ， 一 个 App 正常 的 启动 流程 如 图 9-1 所 示 。 





图 9-1 App 启动 流程 图 
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打开 软件 后 , 首先 展示 的 是 启动 页 (启动 页 是 每 次 打开 都 会 展示 , 一 般 停留 1 秒 到 2 秒 左右 )， 
然后 判断 用 户 是 否 第 一 次 启动 ， 如 果 是 第 一 次 启动 就 进入 引导 页 ,然后 进入 首页 ; 如 果 不 是 第 一 次 
启动 ， 就 直接 进入 首页 。 

启动 页 比较 简单 ， 仅 展示 一 张 图 片 ， 如 图 9-2 所 示 。 








图 9-2 启动 页 效果 (图 片 来 源 于 网 络 ) 


引导 页 有 三 页 ， 展 示 了 三 张 图 片 ， 可 以 左右 滑动 进行 切换 ， 并 且 底 部 有 圆 点 表示 一 共有 几 页 ， 
有 颜色 的 圆 点 表示 当前 页 选中 ， 灰 色 圆 点 表示 当前 页 未 选中 。 效 果 图 如 图 9-3 所 示 。 





< 
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图 9-3 引导 页 效果 
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9.1.1 需求 分 析 


在 实际 开发 中 ， 当 我 们 拿 到 产品 需求 文档 跟 产品 模型 时 ， 第 一 件 事情 要 做 的 就 是 对 功能 点 进 
行 分 析 ， 对 模块 进行 拆 分 ， 这 样 开发 更 有 效率 。 
启动 页 会 停留 1~2 秒 ， 需 要 使 用 Handler 延迟 几 秒 后 执行 。 
启动 页 需要 判断 是 否 第 一 次 启动 软件 ， 如 果 是 第 一 次 就 进入 引导 页 ， 如 果 不 是 第 一 次 就 进入 
首页 。 判 断 的 值 可 以 使 用 SharedPreferences 类 进行 保存 。 
引导 页 一 共有 三 页 ， 可 以 左右 滑动 ， 也 可 以 使 用 ViewPager 显示 。 
引导 页 底部 有 显示 圆 点 ， 可 以 使 用 LinearLayout 动态 添加 ， 设 置 水 平 布局 。 
监听 ViewPager 的 滑动 来 决定 圆 点 的 显示 ， 并 且 滑 动 到 最 后 一 页 就 显示 “立即 启动 ”按钮 ; 
如 果 已 处 于 最 后 一 页 ， 还 向 右边 滑动 ， 就 直接 进入 首页 。 
@ 从 引导 页 进入 首页 之 前 ， 将 SharedPreferences 保存 的 boolean 类 型 的 值 设 置 为 true。 


9.1.2 ”代码 实现 


新 建 项 目 ， 新 建 LauncherActivity (启动 页 ) 和 FirstLauncherActivity〈 引 导 页 ) 两 个 Activity 
类 ，AndroidManifest.xml 中 程序 的 入 口 改 为 LauncherActivity。 修 改 后 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.ansen.firstlauncher"> 


<application “ouios 7 
<activity android:name=".LauncherActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<activity android:name=".FirstLauncherActivity"/> 
<activity android:name=".MainActivity"/> 
</application> 
</manifest> 


9.1.3 ”启动 页 


启动 页 加 载 的 布局 文件 为 activity_ launcherxml， 仅 包含 一 个 ImageView。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
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<ImageView 
android:layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 


android:src="@mipmap/bg launcher"/> 
</LinearLayout> 


启动 页 LauncherActivity.java 在 onCreate 方法 中 调用 了 start 方法 ， 在 start 方法 中 使 用 Handler 
延迟 一 秒 执行 Runnable， 在 Runnable 的 run 方法 中 调用 isFirstLauncher() 来 判断 是 否 第 一 次 启动 ， 
根据 返回 的 boolean 类 型 跳 转 到 不 同 的 Activity。isFirstLauncher 方法 就 两 行 代码 ,首先 获取 context 
的 SharedPreferences 对 象 ， 调 用 它 的 getBoolean 方法 获取 是 否 是 第 一 次 启动 的 boolean 值 。 


public class LauncherActivity extends AppCompatActivity { 


public static final String FIRST LAUNCHER="first launcher";// 是 否 第 一 次 启动 
private final long waitTime = 1000; 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity launcher); 


start (); 
} 


Public void start(){ 
new Handler() .postDelayed (new Runnable(){ 
Public void run() { 
Intent intent; 
ifE(isFirstLauncher ()){ 


// 为 true 时 第 二 次 启动 ,因为 第 一 次 启动 时 会 把 FIRST LAUNCHER 的 值 变 为 true 
intent=new Intent (LauncherActivity.this,MainActivity.class); 
}else{// 第 一 次 启动 
intent=new Intent (LauncherActivity.this, 


FirstLauncherActivity.class); 
} 


startActivity (intent); 


finish(); 
} 


}，vwaitTime) 


/x** 


* false: 第 一 次 启动 ，true: 第 二 次 启动 ， 这 里 不 能 用 Activity 的 getPreferences 方法 ， 


因为 需要 多 个 Activity 使 用 一 个 SharedPreference 对 象 , 所 以 调用 getSharedPreferences 方法 。 
* @return 


本 办 
Public boolean isFirstLauncher (){ 
SharedPreferences 
sp=getSharedPreferences ("ansen",Context .MODE PRIVRTE) 


return sp.getBoolean(FIRST LAUNCHER, false); 
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9.1.4 引导 页 


引导 页 的 布局 文件 为 activity_first_launcher.xml， 最 外 层 是 RelativeLayout 布局 ，ViewPager 用 
于 显示 图 片 , TextView 默认 是 隐藏 的 ， 当 滑动 到 最 后 一 页 时 将 显示 “立即 体验 ”按钮 。LinearLayout 
用 来 显示 下 方 的 圆 点 ， 告 诉 用 户 滑动 到 了 第 几 页 。 
<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 


android:layout height="match parent" 
android:orientation="vertical"> 






<android.support.v4.view.ViewPager 
android:id="@+id/viewPager" 
android:layout width="match parent" 
android:layout height="match parent"/> 


<TextView 
android:id="@+id/tv goto main" 
android:layout above="@+id/viewGroup" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginBottom="30dp" 
android:layout marginLeft="100dp" 
android:layout marginRight="100dp" 
android:layout marginTop="40dp" 
android:background="#fc0048" 
android:textColor="#ffffffff" 
android:paddingTop="10dp" 
android:paddingBottom="10dp" 
android:gravity="center horizontal" 
android:textSize="18sp" 
android:visibility="gone" 
android:text=" 立 即 体验 "/> 


<LinearLayout 

android:id="@+id/viewGroup" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout marginBottom="20dp" 
android:gravity="center horizontal" 
android:orientation="horizontal" /> 

</RelativeLayout> 


新 建 FirstLauncherActivityjava 类 ， 用 来 展示 引导 页 。 


Public class FirstLauncherActivity extends AppCompatActivityt{ 
Private ViewPager viewPager; 
// 图 片 数 组 
Private int[] images=new int[]{R.mipmap.bg launcher one,R.mipmap.bg 
launcher two,R.mipmap.bg_ launcher three}; 
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private List<View> mImageViews = new RrrayList<>() ;// 显 示 图 片 View 
private List<ImageView> tips=new ArrayList<>();// 显示 圆 点 View 
Private ViewGroup group; 


private EdgeEffectCompat rightEdge; 
private TextView tvGotoMain; 


@Override 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity first launcher); 


group = (ViewGroup) findViewById(R.id.viewGroup); 
ViewPager = (ViewPager) findViewById(R.id.viewPager); 
tvGotoMain= (TextView) findViewById(R.id.tv goto main); 


try { 
Field rightEdgeField = 
ViewPager.getClass () .getDeclaredField ("mRightEdge"); 
if (rightEdgeField != null)1{ 
rightEdgeField.setAccessible (true) 7 
rightEdge = (EdgeEffectCompat) rightEdgeField.get (viewPager); 
} 
} catch (Exception e) { 
e.printStackTrace (); 


// 将 图 片 装 载 到 数组 中 

for (int i = 0; i < images.length; i++) { 
ImageView imageView = new ImageView (this); 
imageView.setLayoutParams (new ViewGroup.LayoutParams (ViewGroup. 
LayoutParams .MATCH PARENT, ViewGroup.LayoutParams.MATCH PARENT)); 
imageView.setScaleType (ImageView.ScaleType.CENTER CROP); 
imageView.setImageResource (images[i]); 
mImageViews.add (imageView); 

. 


// 将 圆 点 加 入 ViewGroup 中 
for (int i = 0; i < images.length; i++) { 
ImageView imageView = new ImageView (this); 
imageView.setLayoutParams (new ViewGroup.LayoutParams (10, 10)); 
if (i == 0) { 
imageView.setBackgroundResource(R.mipmap.icon first launcher 
Page select one); 
} else { 
imageView.setBackgroundResource (R.mipmap.icon first launcher 
Page normal); 
小 
tips.add(imageView) 
LinearLayout .LayoutParams layoutParams = new 
LinearLayout .LayoutParams (new 
ViewGroupP .LayoutParams (ViewGroup.LayoutParams .WRAP CONTENT, 
ViewGroup.LayoutParams. WRAP CONTENT)); 
layoutParams .leftMargin = 10;// 左 边 距 
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layoutParams .rightMargin = 10;// 右 边 距 
group .addView (imageView, layoutParams); 


} 


viewPager.setAdapter (new PreviewImageAdapter());// 设置 Adapter 


ViewPager.setOffscreenPageLimit (2); 
viewPager.addOnPageChangeListener (onPageChangeListener); 


// 设置 监听 ， 主 要 是 设置 圆 点 的 背景 





tvGotoMain.setOnClickListener (onClickListener); 
| 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.tv goto main: 
gotoMain(); 
break; 


Private ViewPager.OnPageChangeListener onPageChangeListener=new 


ViewPager.OnPageChangeListener() { 
@Override 
Public void onPageScrolled(int position, 


positionOffsetPixels) {} 


float positionOoffset, int 


@Override 
Public void onPageSelected(int position){ 
if (position==images.length-1) {// 最 后 一 页 
tvGotoMain.setVisibility (View.VISIBLE); 


}else{ 
tvGotoMain.setVisibility (View.INVISIBLE); 


} 
setImageBackground (position); 


@Override 
Public void onPageScrollStateChanged(int state) { 
if(rightEdge!=nullg&g&!rightEdge.isFinished()){ 
// 到 了 最 后 一 张 并 且 继 续 抑 动 ， 出 现 蓝 色 限 制 边 条 


gotoMain(); 


/x* 
* 设置 选中 的 tip 的 背景 
* @param selectItems 
六 
Private void setImageBackground(int selectItems) { 
for (int i mam 0; 1 < tipsssize()? 4++ty { 
if (i == selectItems) { 


326 | Android App 开发 从 入 门 到 精通 





if (i==0){ 

tips.get (i) .setBackgroundResource 

(R.mipmap.icon first launcher Page select one); 
}else if(i==1){ 

tips.get (i) .setBackgroundResource 

(R.mipmap.icon first launcher page select two); 
}else if(i==2){ 

tips.get (i) .setBackgroundResource 

(R.mipmap.icon first launcher page select three); 
时 

} else { 

tips.get (i) .setBackgroundResource 

(R.mipmap.icon first launcher page normal); 


3 


Public class PreviewImageAdapter extends PagerAdapter { 
@Override 
Public int getCount() { 
return mImageViews.size(); 


} 


@Override 

Public boolean isViewFromObject (View arg0, Object argl) { 
return arg0 == argl; 

@Override 


Public void destroyItem(View container, int position, Object object) { 
if (position < mImageViews.size()) { 
((ViewPager) container) .removeView (mImageViews .get (position)); 
} 
. 


@Override 

Public Object instantiateItem(View container, int position) { 
((ViewPager) container) .addView (mImageViews.get (position)); 
return mImageViews.get (position); 


Private void gotoMain(){ 
SetFirstLauncherBoolean () 7 
Intent intent=new Intent (FirstLauncherActivity.this,MainActivity.class); 
startActivity (intent) 7 
finish() 7 
L 


/** 
* 第 一 次 启动 执行 完成 ， 值 设置 为 true 
hd 
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Public void setFirstLauncherBoolean(){ 
SharedPreferences sp=getSharedPreferences("ansen",Context .MODE PRIVATE); 
SharedPreferences.Editor edit=sp.edit (); 
edit.putBoolean (LauncherActivity.FIRST LAUNCHER,true); 
edit.commit (); 


} 


首先 查看 oncreate 方法 来 查找 三 个 控件 ， 通 过 反射 获取 ViewPager 的 私有 属性 mRightEdge， 
初始 化 图 片 数组 View， 初 始 化 圆 点 的 View， 并 且 逐 个 加 入 到 LinearLayout 中 。 为 ViewPager 设置 
适配器 ， 添 加 页 面 改 变 监听 事件 ， 给 立即 体验 的 TextView 也 设置 点 击 事件 。 


onClickListener 处 理 了 立即 体验 的 点 击 事件 ， 直 接 调用 gotoMain 方法 跳 转 到 首页 。 
onPageChangeListener 必须 要 重 写 三 个 方法 ( onPageScrolled 、 onPageSelected 、 
onPageScrollStateChanged )。onPageSelected 方法 是 在 页 面 选中 时 调用 ， 首 先 判断 是 否 处 于 最 
后 一 页 ， 如 果 是 最 后 一 页 就 显示 “立即 体验 ”按钮 。 接 下 来 调用 setImageBackground 方法 来 
更 新 圆 点 的 显示 。onPageScrollStateChanged 方法 在 页 面 滚动 状态 改变 时 调用 ， 如 果 用 户 滚动 
到 最 后 一 张 图 片 并 且 还 想 向 右 滑 动 ， 则 直接 调用 gotoMain 方法 进入 首页 。 

@ PreviewImageAdapter 继承 自 PagerAdapter， 是 ViewPager 控件 的 适配器 ， 主 要 重 写 三 个 方法 
getCount (获取 Item 总 数 )、destroyItem ( 删除 Item )、instantiateItem (添加 Item )。 

@ ”gotoMain 方法 调用 setFirstLauncherBoolean 方法 将 第 一 次 启动 的 布尔 类 型 设置 为 true, 并 且 发 
送 一 个 Intent 开启 首页 的 Activity， 关 闭 当前 界面 。 

esetFirstLauncherBoolean 将 是 否 第 一 次 启动 的 布尔 类 型 变量 设置 为 tue， 除 非 用 户 邵 载 软件 ， 
不 然 这 个 变量 一 直 是 true。 


9.2 ”检查 更 新 并 下 载 安装 


检查 更 新 是 任何 App 都 会 用 到 的 功能 ， 任 何 App 不 可 能 在 第 一 个 版 本 就 将 所 有 的 需求 全 部 实 
现 ， 只 有 通过 不 断 地 挖掘 需求 和 完善 ， 才 能 使 App 变 得 越 来 越 好 ， 这 就 需要 软件 不 停 地 升级 。 检 
查 更 新 自动 并 下 载 安装 分 为 以 下 几 个 步骤 : 
(1) 请 求 服务 器 判断 是 否 有 最 新 版 本 〈 通 过 versionCode) 。 
(2) 如 果 有 最 新 版 本 ， 就 将 最 新 的 apk 文件 下 载 到 本 地 。 
(3) 下 载 完 成 之 后 ， 给 系统 发 起 一 个 安装 的 Intent。 
打开 项 目 App 的 build.gradle 文件 ， 可 以 看 到 其 中 有 versionCode 和 versionName 两 个 属性 : 
versionCode 是 一 个 整 型 类 型 的 值 ， 用 来 更 新 版 本 ; versionName 是 一 个 浮 点 型 的 值 ， 可 以 告诉 用 户 
当前 的 版 本 号 。 每 次 App 升级 时 ， 都 要 对 这 两 个 值 进行 增加 。 这 里 使 用 默认 值 即 可 。 
因为 检查 更 新 需要 请 求 服务 器 ， 所 以 引入 之 前 封装 的 okhttp 库 : 


compile 'com.ansen.http:okhttpencapsulation:1.0.1' 


需要 访问 网 络 和 写 入 SD 卡 的 权限 ， 记 住 在 AndroidManifest.xml 中 增加 权限 。 
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<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE"/> 


需要 重 写 Application, 并 且 在 AndroidManifest.xml 文件 中 给 application 标签 name 属性 指向 
写 的 MyApplication， 在 MyApplication 中 初始 化 HTTPCaller。 




















public class MyApplication extends Application { 
@Override 
public void onCreate() { 
super.onCreate () 7 


HttpConfig httpConfig = new HttpConfig(); 

httpConfig.setAgent (true) ;// 有 代理 的 情况 能 不 能 访问 

httpConfig.setDebug (true) ;// 是 否 是 debug 模式 ， 如 果 是 debug 模式 就 打印 日 志 
httpConfig.setTagName ("ansen") ;// 打 印 日 志 的 TagName 


// 可 以 添加 一 些 公 共 字段 ， 每 个 接口 都 会 带 上 

httpConfig.addCommonField ("pf", "android"); 

httpConfig.addCommonField("version code", "" + Utils.getVersionCode 
(getApplicationContext ())); 


// 初 始 化 HTTPCaller 类 
HTTPCaller.getInstance () .setHttpConfig (httpConfig); 


} 


我 们 将 version_code 作为 公共 参数 ,通过 Utils 类 的 getVersionCode 方法 获取 值 。getVersionCode 
方法 需要 传 入 一 个 context 对 象 , 通过 Context 获取 包 管理 器 ,调用 PackageManager 的 getPackageInfo 
方法 获取 包 信 息 ， 调 用 它 的 公有 属性 versionCode 来 获取 当前 版 本 号 。 


public static int getVersionCode (Context ctx) { 

// 获取 packagemanager 的 实例 

int version = 0; 

try { 
PackageManager packageManager = ctx.getPackageManager (); 
//getPackageName () 是 当前 程序 的 包 名 
PackageInfo PackInfo = 

packageManager .getPackageInfo (ctx.getPackageName (), 0); 

version = packInfo.versionCode; 

} catch (Exception e) { 
e.printStackTrace (); 





} 
return version; 


} 


新 建 项 目 ， 修 改 MainActivity.java 对 应 的 activity_main.xml 文件 ， 里 面 就 两 个 控件 ，TextView 
用 来 显示 当前 版 本 号 ，Button 用 来 “检查 更 新 ”。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match Parent" 
android:layout height="match parent" 
android:orientation="vertical" 
android:padding="10dp"> 
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<TextView 
android:id="@+id/tv current version code" 
android:layout width="match parent" 
android:layout height="wrap content" 
:gravity="center horizontal" 
:textSize="16sp" 
android:text=" 当 前 版 本 "/> 






<Button 
android:id="@+id/btn check update" 
android:layout marginTop="10dp" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text=" 检 查 更 新 "/> 
</LinearLayout> 


接 下 来 看 布局 文件 对 应 的 MainActivityjava。 为 了 方便 学 习 ， 这 里 先 看 一 部 分 代码 ，onCreate 
给 显示 当前 版 本 的 TextView 赋值 ， 以 及 为 “检查 更 新 ”按钮 设置 点 击 监听 。 点 击 按钮 时 发 送 一 个 
Get 请 求 服务 器 。 我 们 想 知 道 有 没有 新 版 本 ， 是 通过 versionCode 的 值 进行 判断 的 ， 但 是 这 里 却 没 
有 在 请 求 url 后 面 添加 参数 ， 因 为 在 MyApplication 中 已 经 将 versionCode 设置 成 了 公共 参数 。 
public class MainActivity extends APPCompatRctivity implements 


View.OnClickListenert{ 
Private ProgressDialog progressDialog; 





@Override 

protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout .activity main); 


TextView tvCurrentVersionCode= (TextView) 
findViewById(R.id.tv current version code); 
tvCurrentVersionCode.setText ("当前 版 本 :"+ Utils.getVersionCode (this)); 


findViewById(R.id.btn check update) .setOnClickListener (this); 
上 


@Override 
public void onClick(View v) { 
Switch (v.getId()){ 
case R.id.btn_check_update:// 检 查 更 新 
HTTPCaller.getInstance () .get (CheckUpdate.class, 
"http://139.196.35.30:8080/0kHttpTest/checkUpdate.do",null, 
requestDataCallback); 

break; 


Get 请 求 回调 监听 ， 先 判断 返回 的 状态 码 。 如 果 状 态 码 等 于 0 表示 有 新 版 本 ， 有 新 版 本 的 话 下 
载 url 也 应 该 赋值 ， 将 下 载 url 传 给 showUpdaloadDialog 方法 。 
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Private RequestDataCallback<CheckUpdate> requestDataCallback=new 
RequestDataCallback<CheckUpdate>(){ 
@Override 
public void dataCallback (CheckUpdate obj) { 
if(obj!=nul1){ 
if (obj .getErrorCode()==0) {// 有 新 版 本 
showUpdaloadDialog (obj .getUr]1 ()); 
}else{// 没 有 新 版 本 
Toast .makeText (MainActivity.this,obj.getErrorReason(), 
Toast .LENGTH LONG) .show(); 
' 
} 


] 7 


showUpdaloadDialog 方法 弹出 是 否 更 新 对 话 框 。 利 用 “是 否 更 新 ”对 话 框 让 用 户 判 断 要 不 要 
更 新 ， 相 对 友好 一 些 。 某 些 公司 的 App 在 用 户 手 机 连接 WiFi 时 直接 从 后 台 下 载 更 新 包 ， 而 不 经 过 
用 户 的 同意 ， 这 种 做 法 欠 妥 。 这 里 设置 一 个 “确认 更 新 ”对 话 框 ， 如 果 用 户 点 击 了 “确认 ”按钮 就 
调用 startUpload 方法 ， 如 果 点 击 “ 取 消 ” 按 钮 ， 就 关闭 对 话 框 ， 不 进行 升级 操作 。 

private void showUpdaloadDialog (final String downloadUr1){ 

// 这 里 的 属性 可 以 一 直 设置 ， 因 为 每 次 设置 后 返回 的 是 一 个 builder 对 象 
AlertDialog.Builder builder = new AlertDialog.Builder (this); 
// 设置 提示 框 的 标题 
builder.setTitle(" 版 本 升级 ") . 
setIcon (R.mipmap.ic launcher) . // 设置 提示 框 的 图 标 
setMessage ("发 现 新 版 本 ! 请 及 时 更 新 ") .// 设置 要 显示 的 信息 
setPositiveButton ("确定 "，new DialogInterface.OnClickListener() { 
// 设置 “确定 ”按钮 
@Override 
Public void onClick(DialogInterface dialog, int which) { 
startUpload (downloadUr1) ;// 下 载 最 新 的 版 本 程序 
} 
}) .setNegativeButton ("取消 "，nul1); 
// 设 置 “ 取 消 ” 按 钮 ,null 是 什么 都 不 做 ， 并 关闭 对 话 框 
AlertDialog alertDialog = builder.create(); 
// 显示 对 话 框 
alertDialog.show(); 
} 


startUpload 方法 首先 创建 一 个 进度 条 对 话 框 , 设置 进度 条 样式 , 设置 messgage, 然后 调用 Utils 
类 的 getSaveFilePath 静态 方法 获取 一 个 sdcard 的 路 径 ， 将 下 载 的 APK 文件 保存 在 这 个 路 径 中 。 接 
下 来 ， 调 用 HTTPCaller 类 的 downloadFile 方法 去 下 载 文件 ， 包 含 三 个 参数 : 下载 unl、 文 件 保存 路 
径 和 下 载 进度 回调 。 下 载 进度 回调 是 一 个 ProgressUIListener 接口 ， 用 内 部 类 方式 重 写 。 这 个 类 有 三 个 
回调 方法 : onUIProgressStart 在 下 载 开 始 时 调用 ， 我 们 将 总 文件 长 度 赋值 给 进度 条 的 总 长 度 ， 然 后 显示 
进度 条 ; onUIProgressChanged 方法 在 进度 改变 时 调用 ， 我 们 在 这 个 方法 中 更 新 进度 条 ; 
onUIProgressFinish 在 下 载 完成 时 调用 , 在 这 个 方法 中 销毁 进度 条 , 调用 openAPK 方法 打开 APK 文件 。 

Private void startUpload(String downloadUr1l)1{ 

ProgressDialog=new ProgressDialog (this); 


ProgressDialog.setProgressStyle (ProgressDialog.STYLE HORIZONTAL); 
progressDialog.setMessage ("正在 下 载 新 版 本 "); 
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progressDialog.setCancelable (false) ;// 不 能 手动 取消 下 载 进度 对 话 框 

final String fileSavePath=Utils.getSaveFilePath (downloadUr1) ; 

HTTPCaller.getInstance () .downloadFile (downloadUr],fileSavePath,null,new 
ProgressUIListener(){ 


@Override 
public void onUIProgressStart (long totalBytes) {// 下 载 开始 


progressDialog.setMax( (int)totalBytes); 
progressDialog.show(); 


} 

// 更 新 进度 

@Override 

public void onUIProgressChanged(long numBytes, long totalBytes, float 


percent, float speed) { 
progressDialog.setProgress((int)numBytes); 


. 

@Override 

public void onUIProgressFinish() {// 下 载 完成 
Toast .makeText (MainActivity.this, "下载 完 成 ", Toast .LENGTH LONG) .show(); 
progressDialog.dismiss(); 
openAPK (fileSavePath); 


1D); 
} 


下 载 完成 后 给 系统 发 送 一 个 安装 APK 的 Intent。 


Private void openAPK (String fileSavePath){ 
Intent intent = new Intent() 7 
intent.addFlags (Intent .FLRAG ACTIVITY NEW TASK); 
intent.setAction(Intent.ACTION VIEW); 
intent.setDataAndType (Uri.parse ("file://"+fileSavePath), 

"application/vnd. android.package-archive"); 

startActivity(intent); 

} 


运行 源 代码 ， 效 果 如 图 9-4 所 示 。 


斋 checkupdate 


一 现 有 F 


ls 纪 
乓 版 本 升级 正在 下 载 新 版 本 
发 现 新 版 本 ! 请 及 时 更 新 








图 9-4 效果 图 
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这 里 为 什么 有 新 版 本 ? 


我 们 查看 第 一 张 效果 图 ， 发 现 当前 的 版 本 是 1。 其 实 我 们 预先 打包 了 一 个 versionCode 等 于 
2 的 签名 APK 放 到 服务 器 上 ， 所 以 只 要 给 的 VersionCode 参数 值 小 于 2 就 是 可 以 升级 的 。 





覆盖 安装 签名 问题 
通过 前 面 的 学 习 ， 我 们 知道 调试 时 直接 运行 App 并 安装 到 手机 上 安装 包 是 临时 签名 ， 所 以 在 
企业 开发 中 每 次 提交 版 本 到 应 用 市 场 时 都 会 用 线 上 签名 文件 进行 签名 ， 保 证 线 上 (应 用 市 场 ) 各 版 


本 的 安装 包 都 是 同一 个 签名 ,只 有 签名 一 样 时 才能 覆盖 安装 。 如 果 签 名 不 一 致 ,点 击 安装 时 会 出 现 
应 用 未 安装 的 情况 。 


我 们 这 个 项 目的 线 上 签名 文件 在 项 目 /jiks 文件 夹 中 ， 这 个 文件 夹 下 还 有 一 个 已 经 签名 的 1.0 版 
本 APK 文件 ， 如 果 想 要 查看 效果 ， 可 以 把 1.0 版 本 的 APK 文件 通过 社交 软件 之 类 发 送 到 手机 上 ， 
点 击 检查 更 新 按钮 ， 下 载 安装 ， 升 级 完成 。 当 然 ， 也 可 以 用 签名 文件 对 APK 签名 。 签 名 文件 和 密 
码 都 在 jks 文件 夹 下 。 


9.3 ”Banner 广告 轮 播 图 


轮 播 图 是 大 部 分 App 都 有 的 效果 ， 尤 其 是 商品 类 和 新 闻 类 的 App。 

轮 插图 的 效果 和 第 一 次 启动 时 的 引导 页 类 似 ， 不 过 轮 播 图 在 引导 页 的 基础 上 多 了 以 下 功能 : 
e 在 第 一 页 也 能 向 左 滑动 ， 在 最 后 一 页 也 能 向 右 滑动 。 

@ 有 一 个 计时 器 ， 每 隔 一 段 时 间 就 滚动 轮 播 图 。 


9.3.1 运行 效果 图 


此 轮 播 图 的 效果 如 图 9-5 所 示 。 在 图 片 集合 中 加 上 一 个 指示 器 , 用 来 表示 当前 滚动 到 第 几 张 图 
片 。 


Banner Banner 





图 9-5 轮 播 图 的 效果 
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9.3.2 ”代码 实现 


activity_main.xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="200dp"> 


<android.support.v4.view.ViewPager 
android:id="@+id/vp banner" 
android:layout width="match Parent" 
android:layout height="match parent"/> 





<LinearLayout 
android:id="@+id/viewGroup" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout centerHorizontal="true" 
android:layout marginBottom="3dp" 
android:orientation="horizontal"/> 
</RelativeLayout> 


最 外 层 是 RelativeLayout， 固 定 高 度 是 200dp， 其 中 有 ViewPager 和 LinearLayout。ViewPager 
用 来 显示 Banner 图 片 ，LinearLayout 显示 圆 点 图 片 ， 表 示 当 前 ViewPager 的 选中 状态 。 
BannerAdapter.java ViewPager 适配器 继承 自 PagerAdapter， 重 写 以 下 四 个 方法 。 





Public class BannerAdapter extends PagerAdapter { 
Private Context context; 
Private View.OnClickListener onBannerClickListener; 


// 图 片 列表 
Private int[] banners=new int[]{R.mipmap.banner one,R.mipmap.banner two, 
R.mipmap .banner three}; 


Public BannerAdapter (Context context){ 
this.context=context; 
} 


@Override 
Public int getCount() { 

return Integer.MAX VALUE;// 返 回 int 的 最 大 值 ， 可 以 一 直 滑动 
. 


@Override 

Public boolean isViewFromObject (View arg0, Object argl) { 
return arg0==argl; 

和 


Override 
Public void destroyItem(ViewGroup container, int position, Object object) { 
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} 


container.removeView( (View) object); 


} 


@Override 

public Object instantiateItem(ViewGroup container, int position) { 
//position 的 值 范 围 是 0~2147483647， 将 这 个 值 对 图 片 长 度 求 余 之 后 ，position 的 
// 取 值 范围 是 0~banners.length-1 
position %= banners.length; 


ImageView imageView = new ImageView (context); 
imageView.setScaleType (ImageView.ScaleType.CENTER CROP) ;// 设 置 图 片 缩放 类 型 
imageView.setTag (Position) ;// 将 当前 的 下 标 通过 setTag 方法 设置 进去 
imageView.setImageResource (banners [position]); 
imageView.setOnClickListener (onClickListener); 
container.addView (imageView); 
return imageView; 

} 


Private View.OnClickListener onClickListener=new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
if(onBannerClickListener!=null){ 
onBannerClickListener.onClick(v); 
} 


ye 


Public void setOnBannerClickListener (View.OnClickListener 
onBannerClickListener) { 
this.onBannerClickListener = onBannerClickListener; 


Public int[] getBanners(){ 
return banners; 
上 


首先 将 要 显示 的 图 片 资源 id 放 到 一 个 名 字 为 banners 的 int 数组 中 ， 这 是 一 个 实例 变量 ， 在 构 
造 方法 中 传 入 context 对 象 。 


@ getCount: 返回 int 的 最 大 值 ， 即 使 滑动 到 最 后 一 页 还 能 向 后 滑动 。 


isViewFromObject: 常规 写法 ， 参 数 1 一 参数 2。 

destroyItem: 删除 一 条 记录 。 

instantiateItem: 添加 一 条 记录 ,首先 传 入 的 position 的 值 为 0 到 int 最 大 值 ,因为 前 面 的 getCount 
方法 就 返回 int 类 型 最 大 值 ， 所 以 这 里 要 对 图 片 数量 进行 求 余 。 求 余 之 后 position 的 值 必定 小 
于 图 片 数 量 , 初始 化 ImageView 对 象 , 设置 图 片 缩 放 类 型 , 将 position 通过 setTag 保存 到 view 
中 ,设置 图 片 资源 ,并 给 图 片 设置 点 击 事件 ,最 后 将 图 片 添加 到 ViewGroup 中 .这 个 ViewGroup 
就 是 ViewPager 自己 。 如 果 查 看 了 源 代 码 ， 就 会 发 现 ViewPager 继承 自 ViewGroup。 
onClickListener : 先 判 断 onBannerClickListener 是 否 为 空 ， 如 果 不 为 空 ， 就 调用 
onBannerClickListener 的 onClick 方法 。 
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@ setOnBannerClickListener: 设置 banner item 点 击 监 听 ， 其 实 就 是 设置 图 片 点 击 。 
egetBanners: 返回 图 片 资源 数组 。 


MainActivity.java 文件 的 内 容 如 下 : 


Public class MainActivity extends AppCompatActivity { 
public static final int CAROUSEL TIME = 5000;//banner 滚动 间隔 


private ViewPager vpBanner;// 


private ViewGroup viewGroup;// 显 示 圆 点 图 片 ， 可 以 看 到 ViewPager 当前 选中 状态 


private BannerAdapter bannerAdapter;//ViewPager 适配器 


Private Handler handler=new Handler(); 
private int currentItem = 0;//ViewPager 当前 位 置 


Private final Runnable mTicker = new Runnable(){ 


|, 


党 


public void run() { 
long now = SystemClock.uptimeMillis(); 
long next = now + (CAROUSEL TIME - now % CAROUSEL TIME) 


handler .postAtTime (mTicker,next); 


// 延 迟 5 秒 再 次 执行 runnable， 效 果 和 计时 器 一 样 


currentItem++; 
VPBanner.setCurrentItem(currentItem) 7 


@Override 
protected void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


vpBanner= (ViewPager) findViewById(R.id.vp banner); 

bannerAdapter = new BannerAdapter (this) ;// 初 始 化 适配器 

bannerAdapter.setOnBannerClickListener (onBannerClickListener); 
// 图 片 点 击 监听 

vpBanner .setOffscreenPageLimit (2) ;// 缓 存 页 数 

vpBanner .setAdapter (bannerAdapter) ;// 设 置 适配器 


vpBanner .addOnPageChangeListener (onPageChangeListener); // 页 面 改 变 监 听 





viewGroup = (ViewGroup) findViewById(R.id.viewGroup);// 显 示 圆 点 控件 
// 将 圆 点 加 入 到 ViewGroup 中 
for (int i = 0; i < bannerAdapter.getBanners().length; i++) { 
ImageView imageView = new ImageView (this); 
// 设 置 图 片 宽 和 高 
imageView.setLayoutParams (new ViewGroup.LayoutParams (10, 10)); 
if (i == 0) { 
imageView.setBackgroundResource (R.mipmap.icon page select); 
} else { 
imageView.setBackgroundResource (R.mipmap.icon page normal); 
} 
LinearLayout .LayoutParams layoutParams = new 


336 Android App 开发 从 入 门 到 精通 





LinearLayout .LayoutParams (new 
ViewGroup .LayoutParams (ViewGroup .LayoutParams .WRAP CONTENT, 
ViewGroup .LayoutParams 。 WRAP CONTENT)); 
layoutParams .leftMargin = 10;// 左 边 距 
layoutParams .rightMargin = 10;// 右 边 距 
ViewGroup.addView (imageView, layoutParams); 
jk 


// 给 ViewPager 设置 当前 页 ， 这 样 刚 打开 软件 时 也 能 向 左 滑动 
CurrentItem = bannerAdapter.getBanners().length * 50; 
VPBanner .setCurrentItem (CUrTentItem) 


handler.postDelayed (mTicker, CAROUSEL TIME) ;// 开 启 计时 器 
| 


private ViewPager.OnPageChangeListener onPageChangeListener=new 
ViewPager.OnPageChangeListener() { 
@Override 
Public void onPageScrolled(int position, float positionOffset, int 


positionOffsetPixels) {} 


@Override 
public void onPageSelected (int Position) { 
currentItem = position; 


// 改 变 圆 点 图 片 的 选中 状态 


setImageBackground (Position %= bannerAdapter .getBanners() .length); 


@Override 
Public void onPageScrollStateChanged(int state) {} 





* @param selectItems 当前 选中 位 置 
Private void setImageBackground (int selectItems){ 
for (int i = 0; i < bannerAdapter.getBanners().length; i++) { 
ImageView imageView = (ImageView) viewGroup.getChildAt (i); 
imageView .setBackgroundDrawable (nul1) ;// 先 将 背景 设置 为 无 
if (i == selectItems){ 
imageView.setImageResource (R.mipmap.icon page select); 
} else { 
imageView.setImageResource(R.mipmap.icon page normal); 








1 


} 


Private View.OnClickListener onBannerClickListener=new 
View.OnClickListener() { 
@Override 
Public void onClick(View view) { 
int position=(Integer) view.getTag(); 


// 从 Tag 中 获取 当前 点 击 的 ImageView 的 位 置 
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Toast .makeText (MainActivity.this," 当前 点 击 位 置 : "+position, 
Toast .LENGTH LONG) .show(); 
} 
jn 


@Override 
protected void onDestroy() { 
super.onDestroy(); 
handler .removeCallbacks (mTicker) ; // 删 除 计时 器 


本 

代码 虽然 比较 多 ， 但 关键 地 方 都 有 注释 ， 简 单 解释 一 下 : 

@ ”onCreate: 查找 ViewPager 控件 ,设置 适配器 ,设置 图 片 点 击 监听 .页 面 滑 动 监听 , 为 ViewGroup 
添加 点 图 片 ， 就 是 滑动 指示 器 。 同 时 给 ViewPager 设置 当前 选中 的 item， 这 个 值 稍微 设置 大 
一 点 ,好 让 用 户 刚 进来 就 能 左右 滑动 ,使 App 更 加 符合 用 户 习惯 .最 后 调用 handlerpostDelayed 
方法 开启 计时 器 ， 有 两 个 参数 : 第 一 个 参数 是 Runnable， 第 二 个 参数 是 延迟 的 时 间 ，5 秒 滚 
动 一 次 轮 播 图 。 

@ onPageChangeListener: 在 onPageSelected 方法 中 将 当前 的 position 赋值 给 currentItem， 调 用 
setImageBackground 方法 改变 圆 点 图 片 的 选中 状态 ， 传 入 一 个 int 类 型 的 值 ( 先 对 position 求 
余 之 后 再 进行 传 入 )。 

esetImageBackground: 改变 指示 器 的 选中 状态 。 循 环 指示 器 ViewGroup， 根 据 显 示 图 片 的 下 标 
决定 指示 器 选中 状态 。 

@ onBannerClickListener: 图 片 点 击 监听 ， 在 这 里 可 以 处 理 图 片 点 击 后 的 操作 。 

@ ”onDestroy: 删除 计时 器 。 在 开发 过 程 中 ， 如 果 有 需要 释放 的 内 容 ， 就 一 定 要 在 onDestroy 中 
添加 。 即 时 释放 资源 是 一 个 程序 员 应 养 成 的 良好 习惯 。 


9.4 微 信 登录 、 分 享 与 支付 


大 部 分 App 都 有 接 入 第 三 方 SDK (软件 开发 工具 包 ) 的 需求 。 例 如 ， 第 三 方 登录 需要 接 入 微 
信 、QQ、 微 博 等 ， 第 三 方 支付 需要 接 入 微 信 、 支 付 宝 、 银 联 等 。 

在 上 面 这 些 SDK 中 ， 需 要 注意 的 是 微 信 不 能 直接 调试 ， 需 要 使 用 正式 的 签名 进行 签名 才能 调 
试 。 另 外 ， 这 些 官方 的 Demo 运行 不 起 来 ， 缺 少 签名 文件 。 


9.4.1 代码 实现 


现在 微 信 的 软件 开发 工具 包 已 经 支持 Android Studio 在 线 引 用 了 ， 之 前 都 是 添加 JAR 的 方法 。 
本 项 目 还 需要 访问 微 信 的 接口 获取 用 户 信息 ， 所 以 需要 将 之 前 封装 的 OkHttp 也 一 起 在 线 引 用 。 
OkHttp 需要 在 自 定义 的 Application 中 初始 化 ， 前 面 已 经 讲 过 多 次 ， 这 里 就 不 贴 出 代码 了 。 新 建 一 
个 项 目 ， 在 app/build.gradle 文件 dependencies 标签 中 加 入 以 下 两 行 代码 ， 在 线 依赖 微 信 SDK 以 及 
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我 们 封装 的 Okhttp 库 : 


compile "com.tencent .mm.opensdk:wechat-sdk-android-without-mta:+'" 
compile 'com.ansen.http:okhttpencapsulation:1.0.1' 


因为 需要 用 到 网 络 ， 所 以 在 AndroidManifest.xml 文件 中 加 入 网 络 权 限 


<uses-permission android:name="android.permission.INTERNET" /> 


activity_main.xml 布局 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:padding="10dp" 
android:orientation="vertical"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 


android:text=" 登 录 之 后 信息 在 这 里 显示 "/> 


<RelativeLayout 
android:layout width="wrap content" 
android:layout height="wrap content"> 


<TextView 
android:id="@+id/tv nickname" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 有 昵称 :"/> 


<TextView 
android:id="@+id/tv age" 
android:layout below="@+id/tv nickname" 
android:layout width="wrap Content" 
android:layout height="wrap content" 
android:text=" 年 龄 :"/> 
</RelativeLayout> 





<Button 
android:id="@+id/btn login" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text=" 微 信和 登录 "/> 


<Button 
android:id="@+id/btn share friend circle" 
android:layout width="match parent" 
android:layout height="wrap content" 


android:text=" 分 享 到 朋友 圈 "/> 


<Button 
android:id="@+id/btn share friend" 
android:layout width="match parent" 
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布局 文件 很 简单 ， 仅 在 LinearLayout 中 放 了 几 个 TextView 和 按钮 。 

WeiXin.java 用 EventBus 来 传送 消息 。 微 信 有 一 个 很 奇怪 的 地 方 ， 就 是 不 管 登录 、 分享 还 是 支 
付 之 后 都 得 用 一 个 Activity 来 接收 ， 所 以 要 从 接收 的 Activity 中 将 结果 信息 通过 EventBus 传递 给 
MainActivity。 虽 然 使 用 广播 也 能 够 实现 ， 但 是 用 EventBus 更 加 简单 易 用 。 
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新 建 Constant.java 文件 ， 用 来 定义 微 信 appid 和 secret 这 两 个 常量 。 这 样 做 的 好 处 是 当 我 们 的 
appid 跟 secret 变化 时 只 需要 修改 常量 。 为 了 保护 隐私 ， 以 下 这 两 个 值 已 经 进行 了 修改 。 


public class Constant { 

public static String WECHAT APPID="wxda6db2aec81389af"; 

public static String WECHAT SECRET="8fed5a2d510022587ef8a6194c965be3"; 
1 


布局 文件 对 应 的 MainActivity.java 代码 全 部 贴 出 来 比较 多 , 这 里 仅 贴 出 MainActivity 部 分 代码 。 


Public class MainActivity extends AppCompatActivity implements 
View.OnClickListener { 
private IWXAPI wxAPI; 
Private TextView tvNickname,tvAge; 
public static final int IMAGE SIZE=32768;// 微 信 分 享 图片 大 小 限制 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 
setContentView(R.layout .activity main); 


EventBus .getDefault () .register (this);// 注 册 
WXxAPI = WXAPIFactory.createWXAPI (this,Constant .WECHAT APPID,true); 
WXxAPI .registerApp (Constant .WECHAT APPID); 


findViewById(R.id.btn login) .setOnClickListener (this); 
findViewById(R.id.btn share friend _circle) .setOnClickListener (this); 
findViewById(R.id.btn share friend).setOnClickListener (this); 
findViewById(R.id.btn pay).setOnClickListener(this); 


tvNickname= (TextView) findViewById(R.id.tv nickname); 
tvAge=(TextView) findViewById(R.id.tv age); 
} 


@Override 
public void onClick(View view) { 
Switch (view.getId()){ 
case R.id.btn login:// 微 信和 登录 
login(); 
break; 
case R.id.btn share friend circle:// 微 信 分 享 到 朋友 圈 
share (true); 
break; 
case R.id.btn share friend:// 微 信 分 享 给 朋友 
share (false); 
break; 
case R.id.btn pay:// 微 信 支 付 
// 先 去 服务 器 获取 支付 信息 ， 返 回 一 个 WeixinPay 对 象 ， 然 后 调用 pay 方法 
showToast (" 微 信 支 付 需 要 服务 器 支持 ") ; 


break; 
| 


太太 
* 这 里 用 到 了 EventBus 框架 
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* @param weiXin 
@Subscribe 
Public void onEventMainThread (WeiXin weixin){ 
Log.i("ansen"nv" 收 到 eventbus 请 求 type:"+weiXin.getType() ) 7 
if (weixin.getType()==1) {// 登 录 
getAccessToken (weiXin.getCode()); 
}else if (weiXxin.getType()==2) {// 分 享 
Switch (weiXin.getErrCode()){ 
Case BaseResp.ErrCode.ERR OK: 


Log.i("ansen"，" 微 信 分 享 成 功 . . . . . . 及， 
break; 

case BaseResp.ErrCode.ERR USER CANCEL:// 分 享 取消 
Log.i("ansen"，" 徽 信 分 享 取消 .....- 本 这 
break; 

case BaseResp.ErrCode.ERR AUTH DENIED:// 分 享 被 拒绝 
Log.i("ansen"，" 微 信 分 享 被 拒绝 ...... ey 
break; 


} 
jelse if (weiXxin.getType()==3) {// 微 信 支 付 
if (weixin.getErrCode ()==BaseResp.ErrCode.ERR OK) {// 成 功 
Log.i("ansen"，" 微 信 支 付 成 功 ...... mw) 2 


Public void showToast (String message){ 
Toast .makeText (this,messagerToast.LENGTH LONG) .show() 


@Override 
Protected void onDestroy() { 
super.onDestroy(); 
EventBus .getDefault () .unregister (this);// 取 消 注册 


onCreate: 首先 订阅 EventBus 消息 ，EventBus 3.0 以 后 版 本 会 通过 反射 扫描 当前 类 中 
@Subscribe 注解 的 方法 。 接 下 来 通过 WXAPIFactory 创建 IWXAPI 类 ， 并 且 注 册 appid， 给 
四 个 按钮 设置 点 击 事件 。 查 找 显 示 名 字 和 年 龄 的 两 个 TextView。 

onClick: 点 击 事件 监听 , 根据 id 来 判断 点 击 不 同 的 按钮 ， 跳 转 到 相应 的 方法 ， 这 些 方法 没 贴 
出 来 ， 后 面 会 单独 讲解 。 

onEventMainThread(WeiXin weiXin): 用 来 接收 EventBus 消息 。 这 个 方法 中 有 一 个 参数 用 来 
判断 接收 类 型 ， 例 如 我 们 这 里 是 WeiXin 对 象 ， 就 是 说 使 用 EventBus 发 送 事件 时 参数 必须 是 
WeiXin 对 象 这 个 方法 才 会 调用 。 首 先 判断 类 型 ， 有 三 种 : 登录 、 分 享 或 支付 。 登 录 成 功 的 情 
况 下 会 获取 到 微 信 的 code， 这 个 code 可 以 理解 为 一 个 微 信号 的 唯一 标示 ， 通 过 code 可 以 获 
取 到 微 信 用 户 信息 。 

showToast: Toast 提示 。 

onDestroy: 取消 EventBus 注册 。 
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9.4.2 ” 微 信 登 录 


微 信 登录 流程 有 以 下 三 个 步骤 : 


(1) 微 信 授权 登录 。 
(2) 根据 授权 登录 获取 微 信 返回 的 code， 然 后 通过 code 获取 access_token。 
(3) 根据 access_token 获取 微 信用 户 资料 。 


当 点 击 “ 登 录 ” 按 钮 时 ， 调 用 的 是 login 方法 ， 包 含 在 MainActivity 中 ， 也 就 是 给 微 信 发 起 一 
个 登录 请 求 ， 弹 出 一 个 授权 界面 。 


Public void login(){ 


} 


SendAuth.Req req = new SendAuth.Req(); 

req.scope = "snsapi userinfo"; 

req.state = String.valueOf (System.currentTimeMillis()); 
WxAPI .sendReq (req); 


在 包 名 的 相应 目录 下 新 建 一 个 wxapi 子 目录 ,然后 在 wxapi 子 目录 下 新 增 一 个 WXEntryActivity 
类 ， 用 来 接收 登录 授权 以 及 分 享 时 微 信 的 回调 信息 。 这 个 类 继承 自 Activity， 需 要 实现 
IWXAPIEventHandler 接口 。 


Package com.ansen.shoenet .wxapi; 
Public class WXEntryActivity extends Activity implements IWXAPIEventHandler { 


private IWXAPI wxAPI; 


@Override 
Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 


WxAPI = WXAPIFactory.createWXAPI (this,Constant .WECHAT APPID,true); 
WXxAPI .registerApp (Constant .WECHAT APPID); 
wxAPI .handleIntent (getIntent (), this); 

上 


@Override 

Protected void onNewIntent (Intent intent){ 
super.onNewIntent (intent) 7 
wxAPI .handleIntent (getIntent () ,this) 7 
Log.i("ansen", "WxXEntryActivity onNewIntent"); 

} 


QOverride 
public void onReq(BaseReq arg0) { 

Log.i("ansen", "WXEntryActivity onReq:"+arg0); 
3 


Q@Override 
Public void onResp (BaseResp resp){ 
if(resp.getType()== ConstantsAPI.COMMAND SENDMESSAGE TO WX) {// 分 享 
Log.i("ansen", " 微 信 分 享 操作 . . . . . . en 
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Weixin weiXin=new WeixXin(2,resp.errCode,""); 
EventBus.getDefault () .post (weixXxin); 

}else if(resp.getType()==ConstantsAPI .COMMAND SENDAUTH) {// 登 录 
Log.i("ansen",，" 微 信和 登录 操作 . .. ... | 
SendAuth.Resp authResp = (SendAuth.Resp) resp; 
Weixin weiXin=new WeixXin(l1,resp.errCode,authResp.code); 
EventBus.getDefault () .post (weiXxin); 

} 

finish(); 


onCreate、onNewIntent 和 onReq 这 三 个 方法 是 固定 写法 。onResp 方法 用 于 接收 微 信 结 果 信息 ， 
首先 判断 类 型 ， 根 据 不 同 的 类 型 去 封装 WeiXin 对 象 ， 如 果 是 登录 操作 ， 就 将 code 传 进去 ， 然 后 
将 封装 好 的 WeiXin 对 象 通过 EventBus 发 送出 去 。MainActivity 的 onEventMainThread 方法 就 会 接 
收 到 这 个 消息 ， 最 后 调用 Finish 关闭 当前 的 Activity。 

WXEntryActivity 需要 在 AndroidManifest.xml 中 注册 : 


<activity 
android:exported="true" 
android:name=" .wxapi .WXEntryActivity"/> 


继续 回 到 首页 的 onEventMainThread， 如 果 登 录 类 型 调用 getAccessToken()， 并 且 传 入 code。 
根据 code 获取 access_token， 这 个 url 是 微 信 公 开 的 ， 需 要 传 入 appid、secret、code 三 个 参数 。 请 
求 成 功 之 后 会 返回 access_token 和 openid 等 信息 。 


Public void getAccessToken (String code){ 
String url = "https://api.weixin.qq.com/sns/oauth2/access token?" + 
"appid="+Constant .WECHAT APPID+"&secret="+Constant .WECHAT_ 
SECRET+"&code="+code+"&grant type=authorization code"; 
HTTPCaller.getInstance () .get (WeixinToken.class, url, null, 
new RequestDataCallback<WeixXinToken>() { 
@Override 
Public void dataCallback (WeiXinToken obj) { 
if (obj .getErrcode () ==0){// 请 求 成 功 
getWeiXinUserInfo (obj) 
}else{// 请 求 失败 
showToast (obj .getErrmsg ()); 
) 


a 
} 
获取 到 access_token 和 openid 之 后 ， 继 续 调用 getWeiXinUserInfo 方法 获取 用 户 信息 。 这 样 能 
够 取 到 当前 微 信 App 登录 用 户 的 一 些 信 息 ， 如 昵称 、 年 龄 、 头 像 地 址 、 语 言 等 基本 信息 。 在 企业 
开发 中 ,到 了 此 步 就 可 以 拿 着 这 些 信 息 调用 自己 服务 器 的 登录 接口 了 。 当 然 ， 这 里 将 昵称 和 年 龄 让 
TextView 显示 。 


Public void getWeiXinUserInfo (WeiXinToken weiXinToken) 1{ 
String Url = "https://api.weixin.qq.com/sns/userinfo?access token="+ 
weiXinToken.getRccess token()+"&openid="+weiXinToken.getOpenid() 
HTTPCaller.getInstance () .get (WeiXinInfo.class, url, null, 
new RequestDataCallback<WeixinInfo>() { 
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@Override 

public void dataCallback (WeiXinInfo obj) { 
tvNickname .setText ("昵称 :"+obj .getNickname ()); 
tvAge .setText ("年 龄 :"+obj .getAge()); 
Log.i("ansen", "头像 地 址 : "+obj .getHeadimgur]l ()); 


DD); 


WeiXinToken 和 WeiXinInfo 这 两 个 实体 类 就 不 贴 代码 了 。WeiXinToken 用 来 映射 获取 访问 
token 接口 返回 的 Json，WeiXinInfo 用 来 映射 获取 用 户 接口 返回 的 Json。 


9.4.3 ” 微 信 分 享 


微 信 分 享 分 为 两 种 : 分 享 到 朋友 圈 和 分 享 给 好 友 ， 统 一 调用 share 方法 。 传 入 一 个 布尔 类 型 来 
判断 是 否 分 享 到 朋友 圈 。 


public void share (boolean friendsCircle){ 


} 


WXWebpageObject webpage = new WXWebpageObject () 
webpage .webpageUrl = "www.baidu.com";// 分 享 url 
WXMediaMessage msg = new WXMediaMessage (webpage); 
msg.title = "分 享 标题 "; 

msg.description = "分 享 描述 "， 

msg.thumbData =getThumbData() ;// 封 面 图 片 byte 数组 


SendMessageToWX.Req req = new SendMessageToWxX.Req(); 
req.transaction = String.valueOf (System.currentTimeMil]lis()); 
req.message = msg; 

req.scene = friendsCircle ? SendMessageToWX.Req.WXSceneTimeline : 
SendMessageToWX.Req.WXSceneSession; 

WxAPI .sendReq (req); 


分 享 内 容 有 很 多 格式 ， 如 分 享 图 片 、 分 享 视频 、 分 享 消息 等 。 下 面 以 分 享 消 息 为 例 ， 这 也 是 
分 享 比较 常见 的 格式 。 首 先 新 建 一 个 WXWebpageObject 对 象 ， 设 置 标题 、 内 容 、 打 开 链 接 、 封 面 
等 ， 然 后 调用 wxAPI 的 sendReq 放松 一 个 请 求 。 

分 享 和 登录 一 样 , 都 会 回调 WXEntryActivity, 然后 又 将 分 享 结果 发 送 给 MainActivity.onEventMainThread 


方法 。 


9.4.4 微 信 支 付 


微 信 支 付 需要 请 求 自己 的 服务 器 ， 从 中 获取 支付 信息 。 获 取 成 功 之 后 调用 pay 方法 。 


Public void pay (WeiXinPay weiXinPay) 1{ 


PayReq req = new PayReq(); 

req.appId = Constant .WECHAT APPID;//appid 
req.nonceStr=weiXinPay.getNoncestr() ;// 随 机 字符 串 ， 不 长 于 32 位 。 推 荐 随机 数 生成 算法 
req.packageValue=weiXinPay.getPackage value() ;// 暂 时 填写 固定 值 Sign=WXPay 
req.sign=weiXinPay.getSign();// 签 名 
req.partnerId=weiXinPay.getPartnerid();// 微 信 支 付 分 配 的 商户 号 
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req.prepayId=weiXinPay .getPrepayid() ;// 微 信和 返回 的 支付 交易 会 话 ID 
req.timeSstamp=weiXinpPay .getTimestamp () ;// 时 间 惟 


WXAPI .registerApp (Constant .WECHAT APPID) 
WxAPI .sendReq (req); 
} 


正常 情况 下 weiXinPay 的 值 是 从 我 们 的 服务 器 获取 的 ,然后 将 返回 信息 封装 到 PayReq 对 象 中 ， 
最 后 调用 wxAPI 的 sendReq 方法 发 起 支付 请 求 。 

在 wxapi 目录 下 新 增 一 个 WXPayEntryActivity 类 ， 和 WXEntryActivity 同 级 ,用 来 接收 微 信 支 
付 的 回调 信息 。 这 个 类 继承 自 Activity， 需 要 实现 IWXAPIEventHandler 接口 。 


public class WXPayEntryActivity extends Activity implements IWXAPIEventHandler { 
private IWXAPI wxAPI; 


Q@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 
WxAPI = WXAPIFactory.createWXAPI (this, Constant.WECHAT APPID); 
wxAPI .handleIntent (getIntent (), this); 

} 


@Override 

Protected void onNewIntent (Intent intent){ 
Super .onNewIntent (intent) ; 
setIntent (intent) 7? 
WxAPI .handleIntent (intent, this); 

} 


@Override 
Public void onReq(BaseReq baseReq) {} 


@Override 
public void onResp(BaseResp resp) { 
Log.i("ansen"，" 微 信 支 付 回调 ， 返 回 错误 码 : "+resp.errCode+" 错误 名 称 :" 
+resp.errStr); 
if (resp.getType() == ConstantsAPI.COMMAND PAY BY WX) {// 微 信 支 付 
Weixin weiXin=new WeiXin(3,resp.errCode,""); 
EventBus.getDefault () .post (weiXin); 
3 
finish(); 


时 

其 他 方法 都 是 固定 写法 ， 在 onResp 中 判断 如 果 是 微 信 登 录 ， 就 封装 一 个 WeiXin 对 象 ， 然 后 
发 送 EventBus 请 求 。 这 样 ，MainActivity 的 onEventMainThread 就 会 接收 到 这 个 WeiXin 对 象 。 

WXPayEntryActivity 需要 在 AndroidManifest.xml 中 注册 。 


<activity 
android:exported="true" 
android:name=" .wxapi .WXPayEntryActivity"/> 


项 目 结构 如 图 9-6 所 示 ， 从 中 可 以 看 到 软件 包 名 为 com.ansen.shoenet。 接 收 微 信 登录 支付 返回 
的 Activity 的 包 名 必须 是 com.ansen.shoenet.wxapi。 两 个 Activity 的 名 字 也 是 固定 的 写法 。 
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DWeixinTest ， 品 app 他 build.gradle 


国 Project ~ 加 不 碍 -上 回 MainActivityjavax (Dapp x 
Tt DoCS An Olona apply plugin: ‘com.android.application" 

和 DI.gradle 

dea android { 
E k compitesdkVersion 26 
| app buildToolsVersion “2 
E build defa 
E libs 
EE sre 
下 





9 
versionCode 1 


DandroidTest 
main versionNane "1.0" 


上 testInstrumentationRunner "android.support,t 
} 


buildTypes { 


Cpres 


activity release { 
Ob MainActivity debuggable true 
app 9 minifyEnabled f 中 se 


proguardFiles getDefauttProguardFite('pr 
bean } 


utils } 

pi } 
WXEntryActivity 

目 WXPayEntryActivity 





dependencies { 

compite fileTree(dir: ‘libs', include: ['*.jar'] 
Te androidTestConpile( 'com.android. support, test ,esp| 
从 AndroidManifest.xml exclude group: ‘com.android.support', module| 








图 9-6 查看 项 目 结构 和 软件 包 名 


9.4.5 ”签名 


微 信和 登录 分 享 支付 都 有 一 个 签名 验证 ， 显 得 很 麻烦 ， 因 为 每 次 调试 都 需要 重新 签名 。 

首先 使 用 Android Studio 生成 一 个 正式 的 签名 文件 ， 签 名 文件 是 以 .jks 结尾 的 ， 这 个 签名 文件 
是 以 后 打包 上 线 一 直 要 用 到 的 ， 然 后 用 这 个 签名 文件 生成 APK 等 名 的 整个 操作 步骤 在 前 面 的 章 
节 有 学 习 ) 。 这 时 App 就 有 了 正式 签名 ， 将 正式 签名 的 APK 发 送 到 手机 上 进行 安装 。 

接 下 来 下 载 一 个 APK 文件 ， 这 是 一 个 通过 包 名 获取 签名 MD5 的 工具 APP， 这 个 工具 是 微 信 
官方 开发 的 ， 官 网 下 载 地 址 如 下 : 

https://res.wx.qq.com/open/zh CN/htmledition/res/dev/download/sdk/Gen Sign 
ature Android2.apk 

以 上 两 个 App 都 安装 好 之 后 ， 打 开 从 微 信 下 载 的 App， 软 件 名 为 “Gen Signature”， 其 中 包 
含 一 个 输入 框 ， 输 入 软件 包 名 ， 点 击 “Get Signature ”按钮 ， 效 果 如 图 9-7 所 示 。 











0 本色 人 A 3 
com.ansen.shoenet 





图 9-7 获取 签名 
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将 图 中 那 行 绿 色 的 十 六 进 制 数 抄 下 来 并 保存 到 txt 文本 中 。 


9.4.6” 微 信 开 放 平台 官网 的 后 台 配 置 


在 微 信 开 放 平 台 官网 (https://open.weixin.qq.com/) 的 首页 点 击 “ 管 理 中 心 ” 后 ,默认 就 是 “ 移 
动 应 用 ”页 面 。 如 果 还 没有 创建 移动 应 用 ， 就 先进 行 创建 ， 如果 已 有 移动 应 用 ， 就 点 击 当前 应 用 右 
侧 的 “查看 ”按钮 ， 进 入 应 用 的 详细 页 面 。 

在 应 用 详细 页 面 中 一 直 向 下 滚动 到 最 底部 ， 看 到 “开发 信息 ”。 点 击 “ 修 改 ”， 进 入 “修改 
应 用 ”页 面 ， 如 图 9-8 所 示 。 


多 中 心 -三 信 开 肝 平 符 <。 全 从 ME 用 -及 和 gotsignature.png 144f < 








=modifyat=managalmodify&type=appalang=zh CN&rok 


应 用 签名 617dd60b1cdobdd810158b0dc7a340d1 








应 用 包 名 





图 9-8 “修改 应 用 ”页 面 


首先 选中 “Android 应 用 ” 复 选 框 ， 然 后 填写 应 用 
签名 , 这 个 签名 就 是 之 前 让 用 户 保存 到 记事 本 上 的 那个 WeixinTest 
值 ， 并 输入 应 用 包 名 。 最 后 点 击 “ 保 存 ” 按 钮 。 


9.4.7 ”运行 软件 


登录 之 后 效果 如 图 9-9 所 示 。 i 
点 击 “ 分 享 到 朋友 圈 ” 按钮 ， 其 效果 如 图 9-10 所 

示 。 分 享 给 好 友 
点 击 “ 分 享 给 好 友 ” 按钮 ， 其 效果 如 图 9-11 所 示 。 ER 











图 9-9 登录 运行 后 的 效果 
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3:29PM 


3:29PM 【| 








图 9-10 分 享 到 朋友 圈 后 的 效果 图 9-11 分 享 给 好 友 的 效果 
微 信 支 付 没 法 测试 ， 因 为 需要 服务 器 支持 。 


9.4.8 微 信 官方 开发 文档 


这 篇 文章 只 是 针对 现在 微 信 的 SDK 版 本 接 入 ， 但 是 SDK 是 可 能 随时 变化 的 ， 如 版 本 变化 、 
接口 变化 等 。 因 此 ， 建 议 大 家 还 是 以 官方 文档 为 主 。 这 篇 文章 仅 作为 参考 。 

移动 应 用 微 信 登录 开发 指南 的 网 址 如 下 : 

https://open.weixin.qq.com/cgi-bin/showdocument?action=dir listg&t=resource 
/res listgverify=1&id=open1419317851l&token=219192a54fl3e8e701llced8e4ce5b36b699 
629c4&1ang=zh_CN 

Android 微 信 支付 开发 手册 的 网 址 如 下 : 


https://open.weixin.qq.com/cgi-bin/showdocument?action=dir 1ist&t=resource 
/res listgverify=1l&id=openl1419317784&token=219192a54fl3e8e701llced8e4ce5b36b699 
629c4&1ang=zh_CN 





(1) 微 信 登录 ， 分 享 ， 支 付 回调 的 Activity 包 名 和 类 名 一 定 要 严格 按照 要 求 去 写 。 
(2) 接收 回调 的 是 Activity， 一 定 要 在 AndroidManifest.xml 中 注册 。 
(3) Constant 中 两 个 常量 的 值 要 去 微 信 申请 并 且 创 建 应 用 才 会 有 ， 这 里 需要 改 成 申请 的 值 。 


(4) 因为 需要 访问 网 络 ， 所 以 记 住 在 AndroidManifest.xml 中 添加 权限 。 

(5 ) 调用 微 信 的 登录 、 分 享 和 支付 时 ， 安 装 包 一 定 要 有 签名 ， 签 名 信息 一 定 要 与 在 微 信 官 
网 上 配置 的 签名 信息 一 致 。 

(6) 微 信 没有 客服 支持 ， 如 果 出 现 问题 ， 请 查看 官方 的 Demo 或 者 官方 API。 

(7) 微 信 SDK 经 常 升 级 ， 开 发 时 尽量 用 最 新 的 版 本 。 
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当然 ,读者 直接 运行 这 里 的 Demo 是 不 行 的 ， 因 为 没有 jks 文件 ， 无 法 签名 ， 并 且 源 代码 中 的 
appid 和 secret 也 被 修改 过 了 ， 是 不 能 使 用 的 。 如 果 只 是 看 运行 效果 ， 笔 者 已 经 在 项 目下 创建 了 一 
个 apk 文件 夹 ， 该 文件 夹 下 放置 了 一 个 可 以 调用 微 信 登录 分 享 的 apk 安装 包 。 


9.5 百度 地 图 


百度 地 图 Android SDK (官方 网 址 为 http://lbsyun.baidu.com/index.php?title=androidsdk) 是 一 套 
基于 Android 4.0 及 以 上 版 本 设备 的 应 用 程序 接口 。 用户 可 以 使 用 该 套 SDK 开发 适用 于 Android 系 
统 移动 设备 的 地 图 应 用 ， 通 过 调用 地 图 SDK 接口 ， 可 以 轻松 访问 百度 地 图 服务 和 数据 ， 构 建功 能 
丰富 、 交 互 性 强 的 地 图 类 应 用 程序 。 

百度 地 图 Android SDK 提供 的 所 有 服务 是 免费 的 , 接口 使 用 无 次 数 限制 。 用 户 申请 密 钥 (Key) 
后 才能 使 用 百度 地 图 Android SDK。 任何 非 营利 性 产品 请 直接 使 用 ， 商 业 目的 产品 使 用 前 请 参考 使 


用 须知 。 





百度 地 图 可 以 实现 丰富 的 LBS 功能 : 


地 图 : 提供 地 图 (2D、3D ) 的 展示 和 缩放 、 平 移 、 旋 转 、 改 变 视 角 等 地 图 操作 。 

室内 图 : 提供 展示 公众 建筑 物 室内 地 图 的 展示 功能 。 

Android Wear: 适 配 Android Wear， 支 持 Android 穿戴 设备 。 

POI 检 索 : 可 以 根据 关键 字 对 POI 数据 进行 周边 、 区 域 和 城市 内 三 种 检索 。 

室内 POI 检索 : 支持 设置 城市 和 当前 建筑 物 的 室内 POI 检索 。 

地 理 编码 : 提供 地 理 坐 标 和 地 址 之 间 相 互 转换 的 能 力 。 

线路 规划 : 支持 公交 信息 查询 、 公 交换 乘 查询 、 驾 车 线路 规划 和 步行 路 径 检索 。 

覆盖 物 : 提供 多 种 地 图 覆盖 物 ( 自 定义 标注 、 几 何 图 形 、 文 字 绘 制 、 地 形 图 图 层 、 热 力图 图 
层 等 )， 满 足 开发 者 的 各 种 需求 。 

定位 : 采用 多 种 定位 模式 ， 使 用 定位 SDK 获取 位 置信 息 ， 使 用 地 图 SDK 的 “我 的 位 置 ”图 
层 进行 位 置 展示 。 

离线 地 图 : 支持 使 用 离线 地 图 ， 节 省 用 户 流量 ， 同 时 为 用 户 带 来 更 好 的 地 图 体验 。 


®” 调 启 百度 地 图 : 利用 SDK 接口 , 直接 在 本 地 打开 百度 地 图 客户 端 或 WebApp, 实现 地 图 功能 。 


周边 雷达 : 利用 周边 雷达 功能 ， 开 发 者 可 在 App 内 低 成 本 、 快 速 实现 查找 周边 使 用 相同 App 
的 用 户 位 置 的 功能 。 


e@ LBS 云 检 索 : 支持 用 户 检索 存储 在 LBS 云 内 的 自 有 POI 数据 ， 并 展示 。 


瓦 片 图 层 : 支持 开发 者 在 地 图 上 添加 自 有 瓦 片 数据 。 


日 特色 功能 : 提供 短 串 分 享 、Place 详情 检索 、 热 力图 等 特色 功能 ， 帮 助 开发 者 搭建 功能 更 加 强 


大 的 应 用 。 
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9.5.1 百度 定位 SDK 


百度 定位 SDK 是 为 Android 移动 端 应 用 提供 的 一 套 简单 易 用 的 定位 服务 接口 ， 专 注 于 为 广大 
开发 者 提供 最 好 的 综合 定位 服务 。 通 过 使 用 百度 定位 SDK， 开 发 者 可 以 轻松 为 应 用 程序 实现 智能 、 
精准 、 高 效 的 定位 功能 。 
1. 坐标 系 说 明 
目前 国内 主要 有 以 下 三 种 坐标 系 : 
@ WGS84: 一 种 大 地 坐标 系 ， 也 是 目前 广泛 使 用 的 GPS ( 全球 卫 星 定 位 系统 ) 使 用 的 坐标 系 。 
GCJ02: 经 过 国 测 局 加 密 的 坐标 。 
BD09: 百度 坐标 系 ， 其 中 bd0911 表示 百度 经 纬度 坐标 ，bd09mc 表示 百度 墨 卡 托 米 制 坐标 。 
2. 使 用 百度 定位 SDK 有 什么 产品 优势 
百度 定位 SDK 提供 GPS、 基 站 、WiFi、 地 磁 、 蓝 牙 、 传 感 器 等 多 种 定位 方式 ， 适 用 于 室内 、 
室外 多 种 定位 场景 ， 具 有 出 色 的 定位 性 能 : 定位 精度 高 、 覆 盖 率 广 、 网 络 定位 请 求 流量 小 、 定 位 速 
度 快 。 
很 多 内 容 已 经 封装 好 了 , 不 需要 去 考虑 什么 情况 使 用 GPS 定位 、 什 么 时 候 使 用 WiFi 定位 、 如 
何 根据 基站 信息 从 联通 或 者 移动 的 API 那里 获取 位 置信 息 。 
3. 百度 定位 SDK 有 四 种 开发 包 
百度 定位 SDK 自 7.0 版 本 起 ， 按 照 附加 功能 不 同 ， 向 开发 者 提供 了 四 种 不 同类 型 的 定位 开发 
包 ， 可 以 根据 不 同 需求 ， 自 行 选择 所 需 类 型 的 开发 包 。 注 意 ， 这 四 种 开发 包 相 互 排斥 ， 一 个 应 用 中 
只 需 集成 一 种 定位 开发 包 即 可 。 
基础 定位 : 开发 包 体积 最 小 ， 但 只 包含 基础 定位 能 力 (GPS/WiFi/ 基 站 )、 基 础 位 置 描述 能 力 。 
离线 定位 : 在 基础 定位 能 力 基础 之 上 ， 提 供 离线 定位 能 力 ， 可 以 在 网 络 环境 不 佳 时 进行 精准 
室内 定位 : 在 基础 定位 能 力 基础 之 上 ， 提 供 室内 高 精度 定位 能 力 ， 精 度 可 达 1~3 米 。 
全 量 定位 : 包含 离线 定位 、 室 内 高 精度 定位 能 力 ， 同 时 提供 更 人 性 化 的 位 置 描述 服务 。 
大 家 可 以 根据 不 同 需求 进行 下 载 ， 一 般 情况 下 只 需要 基础 定位 即 可 。 这 个 Demo 中 的 就 是 基 
础 定位 SDK。 
http://lbsyun.baidu.com/sdk/download?selected=location all 
4. 申请 密 钥 
无 论 使 用 定位 SDK 还 是 地 图 SDK， 都 必须 要 申请 密 钥 (Key) 。 
申请 密 钥 之 前 ， 需 要 有 一 个 百度 开发 者 账号 ， 如 果 没 有 就 需要 注册 一 个 。 在 百度 地 图 SDK 官 
网 首页 右上 角 就 能 看 到 “注册 ”按钮 ， 注 册 流 程 和 其 他 网 站 类 似 。 
登录 注册 后 的 账号 ， 然 后 用 浏览 器 打开 申请 密 钥 的 地 址 : 
http://lbsyun.baidu.com/apiconsole/key 
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进入 申请 密 钥 的 首页 点击“ 创建 应 用 ”按钮 ， 如 图 9-12 所 示 。 





我 的 应 用 习 应 用 列表 认证 状态 : 未 认证 
| seem 
Wa AAk 
FE EE3 
开 的 服务 
CE 
后。 二 用 名 称 Wg (Mk) xa (全 名。 sen 
我 的 数据 sara 
PT 





图 9-12 ”点击 “创建 应 用 ”按钮 
进入 “创建 应 用 ”页 面 ， 如 图 9-13 所 示 。 


应 用 名 称 :BaiduLocationTest 


应 用 类 型 : Android SDK 有 


云 检索 API 固 Geocoding APIv2 。 固 Android 地 图 SDK 
图 Android 症 位 SDK Android 叶 航次 线 5DK 。 国 Android 叶 航 SDK 
启用 服务 鹏 志 豆 API 全 景 静 坊 加 AP1 图 坐标 转换 API 
声 艰 API 加 全 员 URL API 回 Android 呈 和 纹 HUD SDK 
去 地 理 编码 APL 图 云 地 理 编 克 AP1 加 上 下 车 点 服务 


"发 布 版 SHAL : 。 8CEB.F078f60A-BFB01ECBDF03-5EC655E708387EE2 。 人 输入 


开发 版 SHA1 : 。 请 输 入 开发 后 SHA1 


* 包 各 :comansenbaidulocationtest 
BC:EB:FO0:78:F6:0A:BF:B0:1E:CB:DF:03:5E:C6:55:E7:08:38:7E:E2;com.ansen.bai 
dulocationtest 
Android SDK 安 全 码 组 成 : SHA1+ 包 名 。( 意 看 详细 配置 方法 ) 新 申请 的 Mobile 
与 Browser 类 型 的 ak 不 再 支持 云 存 储 接 口 的 访问 ， 如 要 使 用 云 存储 ,请 申请 
Server 关 型 ak 


[wx 
图 9-13 “创建 应 用 ”页 面 





在 “创建 应 用 ”页 面 中 ， 有 四 个 地 方 需要 填写 值 。 

(1) 在 “应 用 名 称 ” 框 中 填写 创建 项 目 时 的 应 用 名 称 。 

(2) 在 “应 用 类 型 ” 框 中 选择 “Android SDK”。 可 以 在 下 方 的 复 选 框 中 选择 启用 服务 ， 这 
里 为 了 测试 ， 选 择 所 有 功能 。 在 实际 开发 时 ， 根 据 自 己 的 需求 进行 选择 。 

(3) 在 “发 布 版 SHA1” 框 中 输入 证 书 指纹 。 该 指纹 可 以 通过 如 下 方法 获取 : 在 项 目的 根 目 
录 下 新 建 jks 文件 夹 ， 用 Android Studio 创建 一 个 .jks 签名 文件 ， 将 签名 文件 放 在 jks 文件 夹 下 。 签 
名 文件 的 密码 保存 在 密码 .txt 中 ， 也 放 在 jks 文件 夹 下 。 接 下 来 ,在 Android Studio 中 打开 终端 ， 输 
入 如 下 命令 : 


keytool -V -list -keystore jks/baidulocationtest.jks 


就 会 看 到 证 书 指纹 ， 效 果 如 图 9-14 所 示 。 
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D3 saidutocationTest 3 app 个 pudgraak 
国 Paject -日 二 亲信 加 actviy_mainxml x 辐 Ninhciviyjvex| 人 appx 目击 btx 区 AndroidMani 
Y 口 BaiduLocationTest ~/Documents /git/glt 了 appty plvgin: ‘com.android.application" 

» 口 .gradle 


上 


androld { 
compitesdKVerston 26 
buildToolsVersion "26.0.0" 


ge 
opp Ucat onTd fom. onsen baidulocationtest” 


targetsdkVersion 26 


me dy se Ba 





Terminal 
+ ansendeNacBook-Pro:BaidulocationTest ansen| keytool ~v -List -keystore jks/baidulocationtest, jks 
x 生 入 本 包 奋 口令: 


于 钥 库 类 型 : JKS 
加 铀 库 提 供 方 : SUN 


您 的 志 铀 库 包 含 1 个 条 目 
别名 : keyg 


创建 日 期 : 2817-9-18 
名目 类 型 : PrivatekeyEntry 










发 aidulocationtest 
序列 号 : 71c48d78 
有 效 央 开始 日 关 : Mon Sep 18 19:31:85 CST 2917， 截 止 日 期 ; Fri Sep 12 19:31:85 CST 2842 


mes i Var 





9-14 查看 证 书 指纹 


最 后 将 “SHA1” 后 面 的 值 复制 到 “SHA1” 输 入 框 中 。 
(4) 在 “ 包 名 ” 框 中 输入 相应 的 包 名 ， 也 就 是 BaiduLocationTest/app/build.gradle 文件 中 
applicationId 对 应 的 值 。 
关于 这 四 个 值 的 填写 方法 ， 用 户 可 以 参考 官方 文件 : 
http://lbsyun.baidu.com/index.php?title=androidsdk/guide/key 
填 好 四 个 值 之 后 ， 点 击 “ 提 交 ” 按 钮 。 提 交 成功 后 会 跳 转 到 “应 用 列表 ”首页 ， 这 时 就 能 看 
到 刚刚 创建 的 应 用 了 ， 同 时 也 能 看 到 “访问 应 用 ”， 如 图 9-15 所 示 。 








局 ) 应 用 列表 认证 状态 : 未 认证 
请 答 和 AK 
每 页 显示 30 条 $ 
应 用 篇 号 应 用 名 称 访 癌 应 用 ( AK ) 应 用 类 别 和 应 用 配置 
10158445 BaiduLocation..| cMFNey4sY2GhINPtCCX4GOA8SZUV8ujp| Android 端 设置 型 除 
您 当前 创建 了 1 个 应 用 1 





图 9-15 查看 创建 的 应 用 
5. 源 代码 实现 
新 建 项 目 ， 在 app/src/main 下 新 建 jniLibs 文件 夹 ， 将 定位 相关 的 so 库 复 制 过 来 ， 同 时 把 百度 
定位 相关 的 jar 包 复 制 到 libs 文件 夹 下 ， 如 图 9-16 所 示 。 
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™ CaBaiduLocationTest ~/Documents/git/git 
> OD .gradle 
> OD .idea 
7 Caapp 
> Dbuild 


» DandroidTest 
Y Dmain 
Y Djava 
> com.ansen.baidumaptest 


Darmeabi-v7a 
国 liblocSDK7a.so 


障 AndroidManifest.xml 
» Otest 


图 9-16 复制 相应 的 文件 





接 下 来 ， 需 要 在 AndroidManifest.xml 文件 中 加 入 定位 权限 和 访问 网 络 的 权限 ， 以 及 定位 的 服 
务 器 ， 还 需要 一 个 meta-data 标签 ， 其 中 name 是 固定 的 。 百 度 SDK 会 根据 这 个 name 来 查找 设置 
的 值 ， 这 个 值 就 是 上 一 步 申 请 的 密 钥 。 

<?xml version="1.0" encoding="utf-8"?> 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.ansen.baidumaptest"> 





<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission android:name="android.permission.ACCESS FINE LOCATION"/> 


<application 
> 





<!-- 百 度 定 位 SDK 需要 服务 --> 
<service 
android:enabled="true" 
android:process=":remote" > 
<intent-filter> 
<action android:name="com.baidu.location.service v2.2" > 
</action> 
</intent-filter> 
</service> 


<!-- 从 百度 地 图 SDK 官网 申请 的 密 钥 --> 
<meta-data 
android:name="com.baidu.lbsapi.API KEY" 
android:value="cMFNey4sY2GhlNPtCCX4G0A8SZUV8ujp"/> 
</application> 
</manifest> 
activity main.xml 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
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android:layout height="match parent" 

android:padding="10dp"> 

<TextView 
android:id="@+id/tv location result" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Hello World!" /> 

</LinearLayout> 


布局 文件 中 仅 有 一 个 TextView， 用 来 显示 定位 的 结果 。 
布局 文件 对 应 的 MainActivityjava 内 容 如 下 : 


public class MainActivity extends AppCompatActivity { 
private LocationClient client = null; 
private TextView tvLocationResult; 


@Override 

Protected void onCreate (Bundle savedInstanceState) { 
Super .onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


tvLocationResult= (TextView) findViewById(R.id.tv location result); 


LocationClientOption mOption=new LocationClientOption(); 
// 定 位 模式 设置 成 高 精度 模式 。 除 了 高 精度 模式 之 外 ， 还 有 Battery_Saving ( 低 功 耗 模式 ) 、 
//Device_ Sensors ( 仅 设备 Gps 模式 ) 。 
mOption.setLocationMode (LocationClientOption.LocationMode.Hight _Rccuracy) 
mOption.setCoorType ("bd0911"); 

// 可 选 ， 默 认为 gcj02， 设 置 返回 的 定位 结果 坐标 系 ， 如 果 配合 百度 地 图 使 用 ， 建 议 设置 为 

//bd0911 moption.setScanSpan(3000) 
// 可 选 ， 默 认 0， 即 仅 定 位 一 次 ， 设 置 发 起 定位 请 求 的 间隔 需要 大 于 等 于 1000ms 才 是 有 效 的 
mOption.setIsNeedAdqdress (true) ;// 可 选 ， 设 置 是 否 需要 地 址 信息 ， 默 认 不 需要 
mOption.setIsNeedLocationDescribe (true) ;// 可 选 ， 设 置 是 否 需 要 地 址 描述 
mOption.setNeedDeviceDirect (false) ;// 可 选 ， 设 置 是 否 需 要 设备 方向 结果 
moOption.setLocationNotify (false); 
// 可 选 ， 默 认为 false， 设 置 是 否 当 gps 有 效 时 按照 1S1 次 频率 输出 GPS 结果 
mOption.setIgnoreKil1Process (true) 
// 可 选 ， 默 认为 true， 定 位 SDK 内 部 是 一 个 SERVICE， 并 放 到 了 独立 进程 ， 
// 设 置 是 否 在 停止 时 杀 死 这 个 进程 ， 默 认 不 杀 死 
mOption.setIsNeedLocationDescribe (true); 
// 可 选 ,默认 为 fal se, 设置 是 否 需要 位 置 详细 信息 , 可 以 在 BDLocation.getLocationDescribe 
// 中 得 到 ， 结 果 类 似 于 "在 北京 天 安 门 附近 ” 
moOption.setIsNeedLocationPoiList (上 true) 
// 可 选 ， 默 认为 false， 设 置 是 否 需要 POI 结果 ， 可 以 在 BDLocation.getPoiList 
// 中 得 到 moption .SetIgnoreCacheException (false) 
// 可 选 ， 默 认为 false， 设 置 是 否 收集 CRASH 信息 ， 默 认为 收集 

moOption.setIsNeedRAltitude (false) 

// 可 选 ， 设 置 定位 时 是 否 需要 海拔 信息 ， 默 认为 fal se， 即 不 需要 ， 除 基础 定位 版 本 外 都 可 用 


Client = new LocationClient (this); 
client .setLocOption (mOption);// 设 置 定位 参数 


client.registerLocationListener (locationListener);// 注 册 监 听 


client.start (); 
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private BDLocationListener locationListener=new BDLocationListener() { 


@Override 
public void onReceiveLocation (BDLocation location) { 
if (null != location && location.getLocType() != BDLocation. 


TypeServerError) { 
StringBuffer sb = new StringBuffer (256); 
sb.append("time : "); 
/太太 
* 也 可 以 使 用 systemclock.elapsedRealtime () 方 法 ,获取 手机 开机 到 现在 的 毫秒 数 ， 
手机 睡眠 〈sleep) 的 时 间 也 包括 在 内 
* location.getTime () 是 指定 位 成 功 后 的 时 间 ， 如 果 位 置 不 发 生变 化 ， 则 时 间 不 变 


和 六 
sb.append (location.getTime()); 
sb.append("\nlocType : ");// 定位 类 型 
sb.append (location.getLocType ()); 
sb.append("\nlocType description : ");// ****x* 对 应 的 定位 类 型 说 明 ***** 
sb.append (location.getLocTypeDescription()); 
sb.append("\nlatitude : ");// 纬度 
sb.append (location.getLatitude()); 
sb.append("\nlontitude :");// 经 度 
sb.append (location.getLongitude()); 
sb.append("\nradius : ");// 半径 
sb.append (location.getRadius ()); 
sb.append("\nCountryCode : "); 
sb.append (location.getCountryCode());// 国家 /地 区 代码 
sb.append("\nCountry : "); 
sb.append (location.getCountry());// 国 家 /地 区 名 称 
sb.append("\ncitycode :");// 城市 编码 
sb.append (location.getCityCode()); 
sb.append("\ncity : ");// 城市 
sb.append (location.getCity()); 
sb.append("\nDistrict : ");// 区 
sb.append (location.getDistrict()); 
sb.append("\nStreet : ");// 街道 
sb.append (location.getStreet ()); 
sb.append("\naddr : ");// 地 址 信息 
sb.append (location.getAddrstr () ) 
sb .append("\nUserIndoorState: ");// ***** 返 回 用 户 室内 外 判断 结果 ***** 
sb.append (location.getUserIndoorState()); 
sb.append("\nDirection(not all devices have value): "); 
sb.append (location.getDirection());// 方向 
sb.append("\nlocationdescribe: "); 
sb.append (location.getLocationDescribe() );// 位 置 描述 
sb.append("\nPoi: ");// POI 信息 
if (location.getPoiList() != null && !location.getPoiList() .isEmpty()){ 
for (int i = 0; i < location.getPoiList().size(); i++) { 
Poi poi = (Poi) location.getPoiList() .get (i); 
sb.append (poi.getName() + ";"); 
} 
} 
if (location.getLocType() == BDLocation.TypeGpsLocation) { 
// GPS 定位 结果 
sb.append("\nspeed : "); 
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sb.append(location.getSpeed() ) ;// 速度 ， 单 位 : km/h 
sb.append("\nsatellite : "); 
sb.append(location.getSatelliteNumber () );// 卫星 数目 
sb.append("\nheight : "); 
sb.append(location.getAltitude() ) ;// 海拔 高 度 ， 单 位 : m 
sb.append("\ngps status : "); 
sb .append(location.getGPsRccuracyStatus () ) ? 
// ****#gps 质量 判断 ***** 
sb.append("\ndescribe : "); 
sb.append ("gps 定位 成 功 ") 
} else if (location.getLocType() == 
BDLocation.TypeNetWorkLocation) 
{// 网 络 定位 结果 
// 运营 商 信息 
if (location.hasAltitude()) {// ***** 如 果 有 海拔 高 度 ***** 
sb.append("\nheight : "); 
sb.append (location.getAltitude());// 单位 : m 


sb.append("\noperationers : ");// 运营 商 信息 
sb.append(location.getOperators ()) 7 
sb.append("\ndescribe : ") 7 
sb.append(" 网 络 定位 成 功 ") ; 

} else if (location.getLocType() == 

BDLocation.TypeOffLineLocation) 

{// 离线 定位 结果 
sb.append("\ndescribe : "); 
sb.append ("离线 定位 成 功 ， 离 线 定位 结果 也 是 有 效 的 ") ; 

} else if (location.getLocType() == BDLocation.TypeServerError) { 
sb.append("\ndescribe : "); 
sb.append(" 服 务 端 网 络 定位 失败 , 可 以 反馈 IMEI 号 和 大 体 定位 时 间 到 loc- 

bugsebaidu.com， 会 有 人 追查 原因 ") 

} else if (location.getLocType() == 
BDLocation.TypeNetWorkException){ 
sb.append("\ndescribe : "); 
sb.append(" 网 络 不 同 导 致 定位 失败 ， 请 检查 网 络 是 否 通畅 ") ; 

} else if 

(location.getLocType()==BDLocation.TypeCriteriaException){ 
sb.append("\ndescribe : "); 
sb .append ("无 法 获取 有 效 定位 依据 导致 定位 失败 ， 一 般 是 手机 的 原因 ， 处 于 飞 
行 模式 下 会 造成 这 种 结果 ， 可 以 试 着 重启 手机 ") ; 
} 
tvLocationResult.setText (sb.toString()); 


@Override 
protected void onDestroy() { 
super.onDestroy(); 


client .stop();// 停 止 定位 


onCreate: 查找 TextView， 新 建 一 个 LocationClientOption 对 象 ， 通 过 
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然后 新 建 一 个 LocationClient 对 象 ， 设 置 定位 参数 ， 注 册 监 听 ， 调 用 start 方法 开启 定位 。 

®@ ”locationListener: 定位 回调 接口 ， 实 现 onReceiveLocation 接口 ， 从 参数 BDLocation 对 象 中 取 
出 地 址 。 

@ ”onDestroy: Activity 销毁 定位 并 停止 。 


运行 软件 ， 效 果 如 图 9-17 所 示 。 
日 甫 全 了 9:18PM 
[SE Te El 


time : 2017-09-18 21:18:46 

locType : 161 

locType description : NetWork location successfull 
latitude 13554 

lontitude : 121.404608 

radius : 100.0 

CountryCode :0 

Country : 中 国 


citycode : 289 


海 市 闵行 区 洱海 路 


operationers :0 
describe : 同 络 定位 成 功 





图 9-17 运行 效果 


9.5.2 百度 地 图 SDK 


百度 地 图 SDK 是 一 套 基 于 Android 2.3 及 以 上 版 本 设备 的 应 用 程序 接口 。 可 以 使 用 该 套 SDK 
开发 适用 于 Android 系统 移动 设备 的 地 图 应 用 ， 通 过 调用 地 图 SDK 接口 ， 可 以 轻松 访问 百度 地 图 
服务 和 数据 ， 构 建功 能 丰富 、 交 互 性 强 的 地 图 类 应 用 程序 。 
1. 获取 定制 的 百度 地 图 SDK 
开发 者 可 以 在 百度 地 图 SDK 的 下 载 页 面 中 下 载 到 新 版 的 地 图 SDK， 下 载 地 址 为 : 
http://developer.baidu.com/map/index.php?title=androidsdk/sdkandev-download 
为 了 给 开发 者 带 来 更 优质 的 地 图 服务 、 满 足 开发 者 灵活 使 用 SDK 的 需求 ， 百 度 地 图 SDK 自 
v2.3.0 起 采用 可 定制 的 形式 ， 为 用 户 提供 开发 包 。 百 度 地 图 SDK 按 功 能 可 分 为 基础 地 图 、 检 索 功 
能 、LBS 云 检 索 、 计 算 工具 和 周边 雷达 五 个 部 分 。 开 发 者 可 以 根据 自身 的 实际 需求 ， 任 意 组 合 这 
五 种 功能 ， 点 击 下 载 页 面 的 “ 自 定义 下 载 ”， 即 可 下 载 相应 的 开发 包 来 完成 自己 的 应 用 开发 。 
”基础 地 图 : 包括 基本 矢量 地 图 、 卫 星 图 、 实 时 路 况 图 、 室 内 图 、 适 配 Android 穿戴 设备 ， 以 
及 各 种 地 图 履 盖 物 、 瓦 片 图 层 、OpenGL 绘制 能 力 。 此 外 ， 还 包括 各 种 与 地 图 相关 的 操作 和 
事件 监听 。 
日 检索 功能 : 包括 POI 检 索 (周边 、 区 域 、 城 市 内 )， 室 内 POI 检 索 ，Place 详情 检索 ， 公 交 信 
息 查询 ， 路 线 规划 ( 驾车、 步行 、 公 交 )， 地 理 编码 / 反 地 理 编码 ， 在 线 建议 查询 ， 短 串 分 享 等 。 
。 LBS 云 检索 : 包括 LBS 云 检索 ( 周边、 区域、 城市 内 、 详 情 ). 
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@ 计算 工具 : 包括 计算 两 点 之 间距 离 、 计 算 短 形 面积 、 坐 标 转换 、 调 启 百度 地 图 客户 端 、 判 断 
点 和 圆 /多 边 形 位 置 关 系 、 本 地 收藏 夹 等 功能 。 
e@ ”周边 雷达 : 包含 位 置信 息 上 传 和 检索 周边 相同 应 用 的 用 户 位 置信 息 功 能 。 


这 里 仅 下 载 基础 地 图 SDK， 在 实际 开发 中 ， 大 家 可 以 根据 需求 下 载 多 功能 SDK。 


“ 申请 密 钥 vy CzBaiduMapTest ~/Documents/git/github/BaiduMapTel 
>» .gradle 


申请 密 钥 的 流程 和 上 一 节 百 度 定位 时 申请 密 
钥 是 一 样 的 ， 这 里 就 不 重复 介绍 了 。 
3. 源 代码 实现 


下 面 使 用 基础 地 图 + 定位 来 实现 当前 在 地 图 > DandroidTest 
上 显示 的 位 置 。 2 
新 建 项 目 , 首先 需要 加 入 百度 的 so 文件 和 jar ni 
包 , so 文件 在 定位 的 基础 上 又 增加 了 两 个 文件 ,而 libBaiduMapSDK_base_v4_4_1.so 
jar 包 数 量 还 是 一 个 没有 变化 ， 如 图 9-18 所 示 。 a AP 们 人 
从 项 目 结构 图 中 看 到 ，jar 的 名 字 和 数量 与 百 res 
位 AndroidManifest.xml 





度 定 位 没有 什么 变化 , 但 是 它 的 内 容 大 小 是 有 变化 上 Dtest 
的 。 0 





图 9-18 项 目 结构 图 





如 果 仔细 对 比 百度 定位 和 百度 地 图 两 个 项 目 
引用 的 jar 包 大 小 ,就 会 发 现 定 位 的 jar 包 是 184KB， 
而 有 定位 + 地 图 功能 的 jar 包 是 3.1MB， 如 图 9-19 所 示 。 




















© @ = “BaiduLBS Android.jar" 简 介 | 地“BaiduLBS_Androidjar” 
本 BaiduLBS_Android.jar 181KB 4 BaiduLBS_Android.jar 3.1MB 
x 修改 时 间 : 今天 上 午 11:12 _w 。 修改 时 间 : 2017 年 8 月 24 日 上 午 11:58 
Y 通用 : | 到 通用 : 
大 小 : 180,730 字 节 (磁盘 上 的 184 大 小 : 3,082,415 字 节 (磁盘 上 的 3.1 
KB) MB 
位 置 Macmtosh HD， 用户， anS6n "又 位 置 : Macintosh HD， 朋 户 .x-ansen 
访 GitGlibuhb 稿 , git ， github 
pp * libs » app * libs 
创建 时 间 : 下 TT 创建 时 间 : 2017 年 8 月 24 日 星期 四 上 午 11:58 
修改 时 间 : 今天 上午 11:12 修改 时 间 : 2017 年 8 月 24 日 星期 四 上 午 11:58 
样 版 样 版 
已 锁定 已 锁定 





9-19 两 个 jar 文件 的 大 小 比较 


所 以 ， 当 从 百度 地 图 下 载 SDK 时 , 根据 功能 选择 相应 的 SDK, 这 样 下 载 的 SDK 的 jar 包 大 小 
就 能 控制 了 ， 而 不 是 选择 了 很 多 功能 ， 然 后 下 载 一 个 SMB 以 上 的 jar 包 ， 结 果 仅 使 用 了 一 个 定位 
功能 。 这 也 是 为 什么 写 两 个 Demo 的 原因 ， 读 者 拿 到 源 代码 复制 到 自己 项 目 中 时 ， 也 要 选择 合适 的 
jar 包 。 

引入 jar 包 和 so 文件 后 ， 接 下 来 在 AndroidManifestxml 中 加 入 权限 ， 配 置 百 度 的 API Key， 
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加 入 百度 定位 需要 的 服务 。 地 图 用 到 的 权限 比较 多 。 


<?xml Version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.ansen.baidumaptest"> 


<uses-permission android:name="com.android.launcher .permission.READ SETTINGS" /> 
<!-- 这 个 权限 用 于 进行 网 络 定位 --> 

<uses-permission android:name="android.permission.ACCESS COARSE LOCATION" /> 
<!-- 这 个 权限 用 于 访问 GPS 定位 --> 

<uses-permission android:name="android.permission.ACCESS FINE LOCATION" /> 
<!-- 用 于 访问 WiFi 网 络 信息 ，WiFi 信息 会 用 于 进行 网 络 定位 --> 

<uses-permission android:name="android.permission.ACCESS WIFI STATE" /> 
<!-- 获取 运营 商 信息 ， 用 于 支持 提供 运营 商 信息 相关 的 接口 --> 

<uses-permission android:name="android.permission.ACCESS NETWORK STATE" /> 
<!-- 用 于 读 取 手 机 当前 的 状态 --> 

<uses-permission android:name="android.permission.READ PHONE STATE" /> 
<!-- 写 入 扩展 存储 ， 向 扩展 卡 写 入 数据 ， 用 于 写 入 离线 定位 数据 --> 

<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 
<!-- 访问 网 络 ， 网 络 定位 需要 上 网 --> 


<uses-permission android:name="android.permission.INTERNET" /> 





<application 


<meta-data 
android:name="com.baidu.lbsapi.API KEY" 
android:value="HLLM33ENPr2k1Ei41Nupx5PewOkGvLjx"/> 


<!-- 百 度 定位 SDK 需要 服务 --> 
<service 
android:name="com.baidu.location.f" 
android:enabled="true" 
android:process=":remote" > 
<intent-filter> 
<action android:name="com.baidu.location.service v2.2" > 
</action> 
</intent-filter> 
</service> 
</application> 
</manifest> 


首先 修改 activity_main.xml 布局 文件 ， 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.baidu.mapapi .map.MapView 
android:id="@+id/mapview" 
android:layout width="match parent" 
android:layout height="match Parent"/> 
</FrameLayout> 
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布局 文件 也 比较 简单 ， 只 有 一 个 自 定义 的 MapView。 这 个 控件 用 来 显示 地 图 ， 是 百度 SDK 中 


的 自 定义 控件 。 


布局 文件 对 应 的 MainActivityjava 内 容 如 下 : 
public class MainActivity extends AppCompatActivity { 


private MapView mapView; 
private BaiduMap baiduMap;// 定 义 地 图 对 象 的 操作 方法 与 接口 
private boolean isFirstLoc = true;// 是 否 首 次 定位 


private LocationClient locationClient = null;// 定 位 控制 类 


@Override 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


// 在 使 用 SDK 各 组 件 之 前 初始 化 context 信息 ， 传 入 ApplicationContext 
// 注 意 该 方法 要 在 setContentView 方法 之 前 实现 
// 在 真实 开发 中 ， 这 名 代码 放 到 自 定义 的 application 中 比较 合适 


SDKInitializer.initialize (getApplicationContext ()); 
setContentView(R.layout .activity main); 


mapView= (MapView) findViewById(R.id.mapview); 
baiduMap = mapView.getMap(); 


baiduMap.setMyLocationEnabled (true) ;// 开 启 定位 图 层 


// 用 户 自 定义 定位 图 标 
BitmapDescriptor mCurrentMarker = 
BitmapDescriptorFactory.fromResource (R.mipmap.icon geo); 


// 参 数 1: 有 三 个 值 

// “LocationMode .COMPASS 为 罗盘 形态 ， 显 示 定 位 方向 圈 ， 保 持 定位 图 标 在 地 图 中 心 
// “LocationMode .FOLLOWING 为 跟随 形态 ， 保 持 定位 图 标 在 地 图 中 心 

// “LocationMode .NORMAL 为 普通 形态 ， 更 新 定位 数据 时 不 对 地 图 做 任何 操作 

// 参 数 2: 是 否 允 许 显示 方向 信息 

// 参 数 3: 用 户 自 定义 定位 图 标 


MyLocationConfiguration config = new MyLocationConfiguration 


(LocationMode .NORMAL, true,mCurrentMarker); 


baiduMap.setMyLocationConfiguration (config);// 设 置 定位 图 层 显示 方式 


startRequestLocation() ;// 开 启 定位 
| 


Private void startRequestLocation() { 
LocationClientOption mOption = new LocationClientOption(); 
// 定 位 模式 设置 成 高 精度 模式 。 除 了 高 精度 模式 之 外 ， 还 有 Battery_Saving ( 低 功 耗 模式 )、 
//Device_Sensors ( 仅 设备 Gps 模式 ) 。 
moption.setLocationMode (LocationClientOption.LocationMode.Hight Rccuracy) 
mOption.setCoorType ("bd0911") ;// 可 选 ， 默认 为 gcj02， 设 置 返回 的 定位 结果 坐标 系 ， 
// 如 果 配 合 百度 地 图 使 用 ， 建 议 设置 为 bda0911; 
mOption.setScanSpan (3000) ;// 可 选 ， 默 认为 0， 即 仅 定位 一 次 ， 设 置 发 起 定位 请 求 的 
// 间 隔 需要 大 于 等 于 1000ms 才 是 有 效 的 


locationClient = new LocationClient (this); 
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locationClient .setLocOption (mOption) ;// 设 置 定位 参数 
locationClient .registerLocationListener (locationListener);// 注 册 监 听 


locationClient.start();// 开 启 定 位 ， 目 前 仅 支持 在 主线 程 中 启动 
} 


private BDLocationListener locationListener=new BDLocationListener() { 


@Override 
public void onReceiveLocation (BDLocation location) { 
if (null != location && location.getLocType() != BDLocation. 


TypeServerError){ 
Log.i("ansen", "getLongitude:"+location.getLongitude ()); 


MyLocationData locData = new MyLocationData.Builder() 
.accuracy (location.getRadius() ) // 设 置 定 位 数据 的 精度 信息 
.latitude (location.getLatitude())// 

.longitude (location.getLongitude()) .build(); 


// 设 置 定 位 数据 ， 只 有 先 允 许 定位 图 层 后 设置 数据 才 会 生效 


baiduMap.setMyLocationData (locData); 


if (isFirstLoc) {// 第 一 次 定位 
isFirstLoc = false; 
LatLng 11 = new LatLng(location.getLatitude(),1ocation. 
getLongitude ()); 
MapStatus.Builder builder = new MapStatus.Builder(); 
builder.target (11) .zoom(18.0f);// 设 置地 图 缩放 级 别 
// 以 动画 方式 更 新 地 图 状态 ,动画 耗 时 300 ms 
baiduMap.animateMapStatus (MapStatusUpdateFactory. 
newMapStatus (builder.build())); 


@Override 

protected void onPause() { 
super.onPause(); 
// 在 Activity 执行 onPause 时 执行 mMapView.onPause () ， 实 现 地 图 生命 周期 管理 
mapView.onPause () 7 

} 


@Override 

protected void onResume(){ 
Super .onResume (); 
// 在 Activity 执 行 onResume 时 执行 mMapView.onResume () ， 实 现 地 图 生命 周期 管理 
mapView.onResume () 7 

} 


@Override 
protected void onDestroy() { 
super.onDestroy(); 


locationClient .stop();// 停 止 定位 
baiduMap.setMyLocationEnabled (false);// 关 闭 定位 图 层 
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4. 


// 在 Activity 执 行 onpestroy 时 执行 mapView.onDestroy() ， 实 现 地 图 生命 周期 管理 
mapView.onDestroy () 7 
mapView=nul17 


onCreate: 首先 初始 化 百度 地 图 相关 SDK， 设 置 首 页 布局 文件 ， 然 后 查找 地 图 控件 并 开启 定 
位 图 层 ， 设 置 定位 图 层 的 显示 方式 ， 最 后 调用 startRequestLocation 方法 开启 定位 。 
startRequestLocation: 如 果 看 过 前 面 的 内 容 ， 开 局 定位 的 代码 大 家 应 该 很 熟悉 了 ， 这 里 就 不 商 
述 了 。 

locationListener: 定位 回调 接口 ， 在 onReceiveLocation 中 处 理 回调 BDLocation 对 象 ， 将 经 纬 
度 封装 到 MyLocationData 对 象 中 ， 调 用 BaiduMap 的 setMyLocationData 方法 更 新 位 置 数据 ， 
判断 是 不 是 第 一 次 更 新 。 如 果 是 第 一 次 ， 就 以 动画 方式 更 新 地 图 状态 。 

onPause: 实现 地 图 生命 周期 管理 。 

onResume: 实现 地 图 生命 周期 管理 。 

onDestroy: 停止 定位 ， 关 闭 定位 图 层 ， 实 现 地 图 生命 周期 管理 。 


签名 配置 


百度 地 图 SDK 和 微 信 SDK 一 样 ， 都 需要 签名 后 的 APK 才能 使 用 。 不 过 ， 如 果 每 次 直接 运行 
App 就 会 产生 一 个 随机 签名 , 将 无 法 进行 测试 , 只 能 在 Android Studio 中 选择 “Build” 一 “Generate 
Signed APK” 命 令 来 生成 一 个 签名 的 APK 文件 。 这 样 调试 起 来 很 麻烦 ， 效 率 很 低 。 

其 实 gradle 支持 配置 签名 文件 , 因为 我 们 一 般 直 接 运 行 的 是 debug 模式 , 所 以 制定 debug 模式 
的 签名 文件 即 可 。 修 改 后 的 app/build.gradle 文件 效果 如 图 9-20 所 示 。 











Project 四 Dapp x 
BaiduMapTest ~/Do 6 appty plugin: "com,android.apptication' 
gradle ER 
] androi 
Br 4 compitesdkVersion 26 


buitdTootsVersion "26,9.0" 










Dbulld defauttConfig { 
Olib: appLicationId “com.ensen.baiduneptest: 
， in5dkVersion 15 
» 并 BaiduLBs_Androidjar - 将 
src versionCode 1 
.gitignore 1 versionNane “1.0" 
oman testInstrunentationRunner “android.support. test. runner. AndroidJUnitRunner" 
© bulld.gradle - 是 
可 proguard-rules.pro TESEE 
» Dbulld 1 signingConfigs { 
> omd release { 
8 keyAlias ‘key0" 
TY Oks keyPassword “baidumaptest 
呈 app-releaseapk 0 Storepassvord “baidumaptest' 
baldumaptestks storeFile fite( "Users/ansen/Docunents/git/github/BaidukapTest/jks/baidunaptest.jks') 
卓 密码 ,bxt 
ganore 
GBaiduMapTest iml 35 builaTypes { 
© build.gradle 6 rear 人 aa tou 
z ny se 
Bgradle.properties 8 proguardFiles getDefaultproguardFile( proguard-android. txt'), ‘proguard-rules.pro’ 
目 gmadlew 
目 gradlew ,bar 
Blocal,properties 1 17 edu 
目 README md 


debug { 
Signingconfig signingcontigs. release 
} 





(© settings .gradle 
吃 External Libraries 





9-20 ”修改 bulid.gradle 文件 





其 中 增加 了 signingConfigs 属性 ,然后 指定 了 release 签名 需要 的 信息 ， 如 签名 文件 地 址 、 签 名 
文件 密码 等 ， 还 需要 在 buildTypes 下 的 debug 模式 中 引用 signingConfigs。 
现在 就 能 够 直接 运行 项 目 了 ， 效 果 如 图 9-21 所 示 。 
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图 9-21 百度 地 图 


第 10 章 
实现 开发 者 头条 


对 于 很 多 Android 初学 者 而 言 ， 我 们 的 项 目 经 验 还 停留 在 演示 的 阶段 ， 有 没有 一 种 失落 的 感 
觉 ? 当 用 户 真正 接手 大 项 目 时, 却 不 知道 如 何 灵活 使 用 自己 已 学 的 知识 。 本 章 将 用 一 个 实例 引导 用 
户 如 何 开发 项 目 。 

开发 者 头条 这 个 App 不 错 ， 其 中 用 到 了 很 多 Android 中 常用 的 技术 。 因 此 ， 本 章 以 模仿 开发 
者 头条 的 功能 ， 将 之 前 学 到 的 知识 串联 起 来 ， 顺 便 复习 前 面 所 学 的 知识 点 。 


ee ER 
10.1 ”启动 页 实现 
开始 今天 的 正题 ， 带 领 用 户 实现 开发 者 头条 App 的 启动 页 。 


10.1.1 启动 页 的 目标 效果 


如 图 10-1 所 示 ， 从 效果 图 中 可 以 看 出 (这 里 列 出 第 一 个 和 第 四 个 页 面 的 效果 图 〉， 使 用 四 个 
页 面 来 显示 四 张 图 片 ， 可 以 左右 滑动 ， 整 个 滑动 的 界面 就 是 使 用 ViewPager 来 实现 的 。 接 下 来 ， 监 
听 ViewPager 的 滑动 事件 ， 改 变 页 面 底部 四 个 横 线 小 图 标的 切换 ， 以 及 点 击 “ 开 启 我 的 头条 ”按钮 
的 隐藏 与 显示 。 
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图 10-1 ”启动 页 的 效果 图 


10.1.2 ”代码 实现 


新 建 项 目 ， 在 res 文件 夹 下 新 建 activity_luancher.xml 文件 ， 内 容 如 下 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="#FCF2E4"> 





<android.support.v4.view.ViewPager 
android:id="@+id/viewpager launcher" 
android:layout width="match parent" 
android:layout height="match parent"/> 


<TextView 
android:id="@+id/tv start headlines" 
android:layout alignParentBottom="true" 
android:layout centerHorizontal="true" 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:layout marginBottom="60dp" 
android:paddingTop="12dp" 
android:paddingBottom="12dp" 
android:paddingLeft="12dp" 
android:paddingRight="12dp" 
android:background="@drawable/start headlines bg" 
android:textColor="@color/launcher item select" 
android:textSize="16sp" 
android:visibility="gone" 


android:text=" 开 启 我 的 头条 "/> 





<LinearLayout 
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android:id="@+id/viewGroup" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout marginBottom="30dp" 
android:gravity="center horizontal™" 
android:orientation="horizontal"/> 


</RelativeLayout> 


该 文件 的 外 层 是 RelativeLayout， 从 上 到 下 分 别 是 ViewPager、TextView、LinearLayout。 其 中 ， 


ViewPager 用 来 显示 滑动 图 片 ，TextView 只 有 滑动 到 最 后 一 页 才 会 显示 ， 点 击 之 后 将 跳 转 到 首页 ; 
LinearLayout 用 来 显示 滑动 状态 。 


“开启 我 的 头条 ”这 个 TextView 默认 是 隐藏 的 ， 该 控件 还 有 一 个 背景 drawable， 设 置 了 背景 


<?xml Version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" > 
<!-- 默认 背景 色 --> 


<solid android:color="@color/white normal"/> 


<! 一 设置 边框 --> 


<stroke 


android:width="1ldp" 
android:color="@color/launcher item select" /> 


<!-- 设置 弧度 --> 
<corners android:radius="3dp"/> 
</shape> 


activity_luancher.xml 布局 文件 对 应 的 LauncherActivityjava 内 容 如 下 : 


public class LauncherActivity extends FragmentActivityt{ 
Private ViewPager viewPager; 
Private LauncherPagerAdapter adapter; 


Private ImageView[] tips; 
Private TextView tvStartHeadlines; 


QOverride 
Protected void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) 
setContentView(R.layout .activity luancher); 


if(!isFirst()){// 不 是 第 一 次 启动 ， 则 直接 进入 首页 
gotoMain(); 


1 


tvStartHeadlines= (TextView) findViewById(R.id.tv start headlines) 
tvStartHeadlines.setOnClickListener (onClickListener); 


ViewPager = (ViewPager) findViewById(R.id.viewpager launcher); 
viewPager.setOffscreenPageLimit (2) ;// 设 置 缓存 页 数 
viewPager .setAdapter (adapter = new LauncherPagerAdapter (this) ) ;// 设 置 适配器 
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viewPager.setOnPageChangeListener (changeListener) ;// 页 面 监听 


ViewGroup group= (ViewGroup)findViewById(R.id.viewGroup); 
// 初 始 化 底部 显示 控件 
tips = new ImageView[4]; 
for (int i = 0; i < tips.length; i++) { 
ImageView imageView = new ImageView (this); 
WE 0) 1{ 
imageView.setBackgroundResource (R.drawable.page indicator 
focused) 
} else { 
imageView.setBackgroundResource(R.drawable.page indicator 
unfocused); 





} 

tips[i] = imageView; 

LinearLayout .LayoutParams layoutParams = new 
LinearLayout .LayoutParams (new ViewGroup.LayoutParams (LayoutParams .WRAP CONTENT, 
LayoutParams .WRAP CONTENT)); 

layoutParams .leftMargin = 10;// 设置 小 横 线 View 的 左边 距 

layoutParams .rightMargin = 10;// 设置 小 横 线 View 的 右边 距 

group.addView (imageView, layoutParams); 


Private OnPageChangeListener changeListener = new OnPageChangeListener() { 
@Override 
Public void onPageScrollStateChanged (int arg0) {} 
@Override 
Public void onPageScrolled(int arg0, float argl, int arg2) {} 
@Override 
Public void onPageSelected (int index) { 
setImageBackground (index) ;// 改变 小 横 线 的 切换 效果 


if (index == tips.length - 1) {// 最 后 一 个 
tvStartHeadlines.setVisibility (View.VISIBLE); 

} else { 
tvStartHeadlines.setVisibility (View.INVISIBLE); 


/ 大 大 
* 改变 小 横 线 的 切换 效果 
* @param selectItems 
wy 
Private void setImageBackground (int selectItems) { 
for (int i = 0; i < tips.length; i++) { 
if (i == selectItems) { 
tips[i] .setBackgroundResource (R.drawable.Page indicator focused); 
} else { 
tips [i] .setBackgroundResource (R.drawable.page indicator unfocused); 
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Private View.OnClickListener onClickListener=new View.OnClickListener() { 
Q@Override 
public void onClick(View view) { 
Switch (view.getId()){ 
case R.id.tv start headlines: 
gotoMain () ;// 进 入 首页 


break; 


] 7 


public void gotoMain() { 
setFirst() ;// 设 置 为 第 二 次 启动 


Intent intent = new Intent(this, MainActivity.class); 
startActivity (intent); 
finish(); 


} 


/rx 
* 是 否 为 第 一 次 启动 :true 表示 第 一 次 启动 ，false 表示 第 二 次 启动 
* Q@return 
a 
Private boolean isFirst() { 
SharedPreferences setting = getSharedPreferences ("headlines", 
Context .MODE PRIVATE); 
return setting.getBoolean ("FIRST", true); 
E 


/x** 


* 将 第 一 次 启动 的 值 设置 为 false 
| 
Public void setFirst(){ 
SharedPreferences setting = getSharedPreferences ("headlines"， 
Context .MODE PRIVATE); 
setting.edit() .putBoolean ("FIRST", false) .commit (); 
上 


@ onCreate: 首先 判断 是 否 为 第 一 次 启动 ， 如 果 不 是 第 一 次 启动 ， 则 直接 进入 首页 ， 给 点 击 跳 
转 到 首页 的 TextView 设置 点 击 事件 , 给 ViewPager 设置 适配器 , 并 且 设置 页 面 改动 监听 函数 ， 
初始 化 底部 显示 控件 ， 就 是 给 LinearLayout 添加 4 个 ImageView， 第 一 个 ImageView 用 于 设 
置 选中 状态 的 图 片 。 

@ changeListener: 页 面 滑动 会 回调 onPageSelected 方法 ， 首 先 改变 小 横 线 的 选中 状态 ， 如 果 选 

中 的 是 最 后 一 页 ， 则 显示 “开启 我 的 头条 ”这 个 TextView。 

setImageBackground: 改变 小 横 线 的 选中 状态 。 

onClickListener: 点 击 “ 开 启 我 的 头条 ”， 将 进入 首页 。 

gotoMain: 设置 为 第 二 次 启动 ， 然 后 跳 转 到 首页 。 

isFirst: 是 否 为 第 一 次 启动 。 

setFirst: 将 第 一 次 启动 的 值 设置 为 false。 
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ViewPager 的 适配器 LauncherPagerAdapterjava 代码 如 下 : 


Public class LauncherPagerAdapter extends PagerAdapter!{ 
private List<View> views; 


// 每 页 显示 的 图 片 
Private int[] images=new int[]{R.drawable.tutorial 1,R.drawable.tutorial 2, 
R.drawable.tutorial 3,R.drawable.tutorial 4}; 


Public LauncherPagerAdapter (Context context){ 
Views=new ArrayList<View>(); 


// 初 始 化 每 页 显示 的 View 
for (int i=0;i<images.length;i++){ 
View item=LayoutInflater.from(context) .inflate(R.layout.activity 
luancher pager item,null); 
ImageView imageview= (ImageView) item.findViewById(R.id.imageview); 
imageview.setImageResource (images[i]); 
views.add (item); 


, 


@Override 
public int getCount() { 
return views == null ? 0 : views.size(); 
y 
@Override 


Public boolean isViewFromObject (View arg0, Object argl) { 
return arg0==argl; 
} 


@Override 
public void destroyItem (ViewGroup container, int position, Object object){ 
container.removeView(views.get (position)); 


. 


@Override 

Public Object instantiateItem(ViewGroup container, int position){ 
container.addView (views.get (position),0); 
return views.get (position); 


} 


LauncherPagerAdapter 继承 自 PagerAdapter。 重 写 PagerAdapter 以 下 四 个 方法 ， 并 且 在 
LauncherPagerAdapter 构造 方法 中 初始 化 四 个 页 面 的 View。 
getCount: 页 面 数量 。 
isViewFromObject: 固定 写法 。 
destroyItem: 删除 一 页 。 
instantiateItem: 添加 一 页 。 


activity_launcher_pager_item.java 是 每 一 页 的 布局 文件 ， 其 内 容 很 简单 ， 就 是 在 FrameLayout 
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中 显示 图 片 视图 (ImageView) ， 图 片 视图 居中 显示 。 


<?xml version="1.0" encoding="utf-8"?> 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<ImageView 
android:id="@+id/imageview" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:src="@drawable/tutorial 1" /> 
</FrameLayout> 


10.2 ”使 用 DrawerLayout 控件 实现 侧 滑 菜单 栏 


现在 开始 模仿 开发 者 头条 的 侧 滑 菜单 ， 是 该 项 目的 第 二 个 知识 点 ， 
相信 大 家 已 经 看 到 很 多 App 使 用 这 种 侧 滑 功能 .下面 使 用 Android 自 带 
DrawerLayout 控件 实现 侧 滑 功能 。 

DrawerLayout 是 SupportLibrary 包 中 实现 侧 滑 菜单 效果 的 控件 ,可 
以 说 DrawerLayout 是 由 于 第 三 方 控件 (如 MenuDrawer 等 ) 的 出 现 之 后 ， 
Google 借鉴 而 来 的 产物 。DrawerLayout 分 为 侧 边 菜单 和 主 内 容 区 两 部 
分 ， 侧 边 菜单 可 以 根据 手势 展开 与 隐藏 (DrawerLayout 自身 的 特性 ) ， 
主 内 容 区 的 内 容 可 以 随 着 菜单 的 点 击 而 变化 (这 需要 使 用 者 自己 实现 ) 。 


10.2.1 侧 滑 菜 单 的 目标 效果 
本 实例 的 效果 如 图 10-2 所 示 。 
10.2.2 代码 实现 


在 res 文件 夹 下 新 建 activity_main.xml 首页 布局 文件 ， 内 容 如 下 : 


<android.support.v4.widget.DrawerLayout 


FA 1059PM 


到 加 前 居 席 六 意 ， 有 加 天 入 
在 






礼物 部 换 
我 的 分 训 
我 的 订阅 
我 的 收 让 
立即 创建 主题 
我 创建 的 主题 
意见 友情 


合作 申请 


图 10-2 侧 滑 菜单 的 效果 


xmlns:android="http://schemas.android.com/apk/res/android" 


android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent" > 


<RelativeLayout 
android:layout width="match Parent" 
android:layout height="match Parent" 
android:clipToPadding="true" 
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android:fitsSystemWindows="true" > 


<include 
android:id="@+id/r] title" 
layout="@layout/layout main title" /> 


<!-- The main content view --> 

<FrameLayout 
android:id="@+id/content frame" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout below: Td/ title™ 
android:background="@color/white normal"> 

</FrameLayout> 

</RelativeLayout> 





<!-- The navigation view --> 
<FrameLayout 

:id="@+id/left drawer" 

ayout width="280dp" 

:layout heigh match Parent" 
android:layout gravity="left"> 





<!-- 左 侧 菜单 --> 
<include layout="@layout/layout main left"/> 
</FrameLayout> 


</android.support.v4.widget .DrawerLayout> 


可 以 看 到 最 外 层 不 是 常用 的 5 大 布局 之 一 ， 而 是 DrawerLayout， 是 版 本 4 包 中 的 类 ， 继 承 自 






ViewGroup。 其 中 包含 RelativeLayout 和 FrameLayout 两 个 子 节点 


FrameLayout 显示 左 侧 菜单 栏 。 主 内 容 区 的 布局 代码 要 放 在 侧 滑 菜单 布局 的 前 面 ， 


DrawerLayout 判断 谁 是 侧 滑 菜单 、 谁 是 主 内 容 区 。 
@ 主 内 容 布局 的 上 方 是 include 标题 栏 布局 文件 ， 下 方 是 一 个 FrameLayout。 
@ 左 侧 菜 单 也 是 使 用 include 方式 加 载 左 侧 菜 单 布局 文件 。 


为 什么 侧 滑 菜单 栏 显示 在 左 侧 呢 ? 


， RelativeLayout 显示 主 内 容 区 ， 


可 以 帮助 


因为 给 FrameLayout 设 置 了 android:layout_gravity 属性 ， 这 个 属性 的 值 决定 侧 滑 出 现在 哪 一 
边 ， 如 果 其 值 为 left 就 出 现在 左边 ; 如 果 其 值 为 right 就 出 现在 右边 。 





layout_main_title.xml 这 个 主 内 容 标题 布局 文件 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@color/launcher item select" 
android:padding="10dp" 
android:orientation="vertical"> 


<ImageView 
android:id="@+id/iv menu" 
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android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:src="@drawable/ic menu white 24dp" /> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginLeft="20dp" 
android:layout toRightOf="@+id/iv menu" 
android:text=" 关 注 公 众 号 [Android 开发 者 666]" 
android:layout centerVertical="true" 
android:textColor="@color/white normal" 
android:textSize="16sp" /> 


<ImageView 

android:id="@+id/iv search" 

android:layout width="wrap content" 

android:layout height="wrap content" 

android:layout alignParentRight="true" 

android:layout centerVertical="true" 

android:src="@drawable/ic search white 24dp" /> 
</RelativeLayout> 


其 中 ， 左 右 两 边 各 一 张 图 片 ， 中 间 显 示 文 字 。 
layout_main_left.xml 这 个 侧 滑 菜单 布局 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@color/white normal" 
android:orientation="vertical" > 





<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@color/main color" 
android:orientation="horizontal" 
android:paddingBottom="80dp" 
android:paddingLeft="15dp" 
android:paddingRight="15dp" 
android:paddingTop="30dp" > 


<ImageView 
android:layout width="40dp" 
android:layout height="40dp" 
android:src="@drawable/default avatar" /> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:layout marginLeft="10dp" 
android:text=" 想 第 一 时 间 看 后 面 文章 ， 扫 码 关 注 我 们 公众 号 哦 一 " 
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android:textColor="@color/white normal" 
android:textSize="12sp"” /> 
</LinearLayout> 


<RelativeLayout 
android:id="@+id/rl home" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginTop="10dp" 
android:background="@drawable/selector left menu item" 
android:padding="@dimen/menu left item padding"> 


<ImageView 
android:id="@+id/iv home" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:src="@drawable/nav icon home"/> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginLeft="30dp" 
android:layout toRightOf="@+id/iv home" 





android:textColor="@drawable/selector left menu item text color" 


android:text=" 首 页 " /> 
</RelativeLayout> 


<View 
android:layout width="wrap content" 
android:layout height="ldp" 
android:background="@color/split line" /> 


<RelativeLayout 
android:id="@+id/rl gift" 
android:background="@drawable/selector left menu item" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:padding="@dimen/menu left item padding"> 





<ImageView 
android:id="@+id/iv gift" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:src="@drawable/nav icon gift" /> 





<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginLeft="30dp" 
android:layout toRightOf="@+id/iv gift" 





android:textColor="@drawable/selector left menu item text color" 
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android:text=" 礼 物 兑换 ” /> 
</RelativeLayout> 


<View 
android:layout width="wrap content" 
android:layout height="ldp" 
android:background="@color/split line" /> 


<RelativeLayout 
android:id="@+id/rl share" 
android:background="@drawable/selector left menu item" 
android:layout width="match Parent" 
android:layout height="wrap content" 
android:padding="@dimen/menu left item padding" > 


<ImageView 
android:id="@+id/iv share" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:src="@drawable/nav icon my shares" /> 


<TextView 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginLeft="30dp" 
android:layout toRightOf="@+id/iv share" 
android:textColor="@drawable/selector left menu item text color" 
android:text=" 我 的 分 享 "/> 
</RelativeLayout> 
</LinearLayout> 


基本 结构 都 类 似 ， 因 此 仅 贴 出 了 上 部 分 的 布局 文件 。 最 外 层 使 用 LinearLayout， 按 照 垂直 方向 
排列 下 来 ， 其 中 每 一 个 RelativeLayout 代表 一 行 。 

selector_left_menu_item.xml 是 左 侧 菜 单 item 选中 背景 的 布局 文件 ， 给 当前 选中 的 项 目 设置 不 
一 样 的 颜色 ， 这 样 下 次 侧 滑 时 就 知道 当前 选中 的 是 哪个 项 目 。 

<?xml Version="1.0" encoding="utf-8"?> 

<selector xmlns:android="http://schemas.android.com/apk/res/android"> 

<item android:drawable="@color/menu left item select" 

android:state selected="true"/> 


<item android:drawable="@color/white normal"/> 
</selector> 


activity_main.xml 首页 布局 文件 对 应 的 MainActivity.java 内 容 如 下 ,需要 注意 的 是 MainActivity 
继承 自 FragmentActivity， 继 承 FragmentActivity 的 好 处 是 Fragment 可 以 在 3.0 以 下 版 本 的 手机 上 
使 用 。 


Public class MainActivity extends FragmentActivityt{ 
Private DrawerLayout mDrawerLayout; 
Private RelativeLayout rlHome, rlGift, rlShare; 
private int currentSelectItem = R.id.rl home;// 默 认 首页 
Private ContentFragment contentFragment; 
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QQOverride 
Protected void onCreate (Bundle savedInstanceState) { 


} 


super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer layout); 
findViewById(R.id.iv menu) .setOnClickListener(clickListener); 
initLeftMenu () ;// 初 始 化 左 侧 菜单 

contentFragment=new ContentFragment (); 
getSupportFragmentManager () .beginTransaction() .add (R.id.content frame, 


contentFragment) .commit (); 


setWindowStatus (); 


Private void initLeftMenu() { 


: 


rlHome = (RelativeLayout) findViewById(R.id.rl home); 
rlGift = (RelativeLayout) findViewById(R.id.rl gift); 
rlShare = (RelativeLayout) findViewById(R.id.rl share); 


rlHome.setOnClickListener (onLeftMenuClickListener); 
rlGift.setOnClickListener (onLeftMenuClickListener); 
rlShare.setOnClickListener (onLeftMenuClickListener); 


rlHome.setSelected (true); 


private OnClickListener onLeftMenuClickListener = new OnClickListener() { 


@Override 
Public void onClick(View v) { 
if (currentSelectItem != v.getId()) {// 防 止 重复 点 击 
currentSelectItem=v.getId(); 
noItemSelect (); 


switch (v.getId()) { 

case R.id.rl home: 
rlHome.setSelected (true); 
contentFragment .setContent ("这 是 首页 "); 
break; 

case R.id.r] gift: 
rlGift.setSelected (true) 
contentFragment .setContent (" 这 是 礼物 兑换 ") ; 
break; 

case R.id.rl share: 
rlShare.setSelected (true); 
contentFragment .setContent ("这 是 我 的 分 享 ") ; 
break; 

} 

mDrawerLayout .closeDrawer (Gravity.LEFT); 
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Private void noItemSelect (){ 
rlHome.setSelected (false); 
rlGift.setSelected (false); 
rlShare.setSelected (false); 


private OnClickListener clickListener = new OnClickListener() { 
@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.iv menu: 
mDrawerLayout .openDrawer (Gravity.LEFT) ;// 打 开 左 侧 抽 层 
break; 


yb 
// 设置 状态 栏 


Private void setWindowStatus() { 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.KITKAT) { 
// 透明 状态 栏 


getWindow() .addFlags (WindowManager .LayoutParams. 
FLAG TRANSLUCENT STATUS); 

// 透明 导航 栏 

getWindow() .addFlags (WindowManager .LayoutParams . 
FLAG TRANSLUCENT NAVIGATION); 

// 设置 状态 栏 颜色 


getWindow() .setBackgroundDrawableResource (R.color.main color); 


@ oncreate:; 查找 DrawerLayout 控件 ， 给 标题 栏 左 侧 的 按钮 设置 点 击 事件 。 初 始 化 左 侧 菜单 ， 
主 内 容 区 域 显示 ContentFragment， 设 置 状态 栏 背 景色 。 
initLefMenu: 初始 化 左 侧 菜单 ， 给 前 面 三 个 item ( 行 ) 设置 点 击 事件 ， 默 认 选 中 第 一 个 。 
onLeftMenuClickListener: 左 侧 菜单 前 三 个 item 点 击 时 调用 ， 首 先 判断 是 否 重复 点 击 ， 如 果 
用 户 连 续 两 次 选中 一 个 菜单 ,我 们 只 让 第 一 次 点 击 有 效 ， 然 后 根据 点 击 不 同 的 item 决定 内 容 
区 域 显 示 不 同文 字 ， 当 然 最 后 不 要 忘记 了 关闭 左 侧 菜单 栏 。 
noltemSelect: 所 有 左 侧 菜单 未 选中 。 
clickListener: 点 击 标题 栏 左边 图 片 时 ， 开 启 侧 滑 菜单 。 
setWindowStatus: Android 系统 等 于 或 者 大 于 4.4 版 本 时 设置 状态 栏 。 


ContentFragment.java 文件 的 主 内 容 区 显示 Fragment: 


Public class ContentFragment extends Fragment{ 
Private TextView tvContent; 


QOverride 
Public View onCreateView (LayoutInflater inflater, ViewGroup 
container,Bundle savedInstanceState) 1{ 
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View rootView=LayoutInflater.from(getRctivity()) .inflate(R.layout. 


tvVContent= (TextView) rootView.findViewById(R.id.tv content) 
return rootView; 
} 


public void setContent (String content){ 
tvContent.setText (content); 
} 
} 


仅 显 示 一 个 带 有 TextView 的 布局 文件 ， 根 据 用 户 点 击 的 项 目 来 决定 显示 什么 字符 串 。 
DrawerLayout 与 Fragment 是 什么 关系 ? 


我 们 看 到 很 多 使 用 DrawerLayonut 的 代码 中 都 同时 使 用 了 Fragment， 这 会 造成 误解 ， 以 为 使 用 
DrawerLayout 必须 用 到 Fragment， 其 实 这 是 错误 的 。 


使 用 Fragment 是 因为 在 侧 滑 菜单 被 点 击 时 ， 如 果 主 内 容 区 的 内 容 比 较 复杂 ， 使 用 Fragment 
去 填充 会 更 容易 ; 如 果 主 内 容 区 仅 有 一 个 简单 的 字符 串 , 只 想 在 不 同 菜单 点 击 时 更 新 一 下 字符 串 的 
内 容 ， 就 没有 必要 使 用 Fragment。 


10.3 ”开发 者 头条 首页 实现 


下 面 实现 开发 者 头条 App 的 首页 ， 其 效果 如 图 10-3 所 示 


Oh 12:46AM 5= 口 


Q 


关 还 公众 号 [Android 开 发 省 666| 


走 自 Android 开 发 666 的 分 


选 自 Android 开 发 666 的 





图 10-3 开发 者 头条 首页 
从 效果 图 中 可 以 看 到 ， 标 题 栏 下 面 有 “ 精 选 ”“ 订 阅 ”“ 发 现 ” 三 个 选项 卡 。 在 “ 精 选 ”页 
面 的 项 部 有 一 个 轮 播 图 ， 轮 播 图 





下 方 是 文章 列表 。 
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10.3.1 源 代码 的 实现 





在 res 文件 夹 下 新 建 fagment_main.xml， 用 作 首 页 Fragment 的 布局 文件 : 


<?xml Version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@color/white normal" > 


<RelativeLayout 
android:id="Q@+id/11 title" 
android:layout width="match parent" 
android:layout height="44dp" > 


<LinearLayout 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@color/main color" 
android:orientation="horizontal" > 


<TextView 
android:id="@+id/tv selected" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:layout weight="1" 
android:gravity="center horizontal" 
:text=" 精 选 " 
:textColor="@drawable/main title txt sel" /> 








<TextView 
android:id="@+id/tv_subscribe" 
android:layout width="0dp" 
android:1layout height rap_content" 
center vertical" 






ravity="center horizontal" 
ext=" 订 阅 " 
android:textColor="@drawable/main title txt sel" /> 





<TextView 






="@+id/tv find" 
ayout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:layout weight="1" 
android:gravity="center horizontal" 
android:text=" 发 现 " 
android:textColor="@drawable/main title txt sel" /> 
</LinearLayout> 





<View 
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android:id="@+id/view indicator" 

android:layout width="15dp" 

android:layout height="2dp" 

android:layout alignParentBottom="true" 

android:background="@color/white normal" /> 
</RelativeLayout> 


<android.support.v4.view.ViewPager 
android:id="@+id/viewpager home" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout below="@+id/1]l1 title" /> 


</RelativeLayout> 


最 外 层 是 RelativeLayout， 其 中 有 两 个 控件 : 第 一 个 控件 是 RelativeLayout， 显 示 Tab 选项 卡 ; 
第 二 个 控件 是 ViewPager， 用 来 显示 三 个 选项 卡 对 应 的 Fragment。 
MainFragmentjava 是 首页 Fragment 文件 ， 内 容 如 下 : 


public class MainFragment extends Fragment { 
private int screenWidth, screenHeight; 


private List<Fragment> list = new ArrayList<Fragment>(); 
Private ViewPager vPager; 

Private FragmentAdapter adapter; 

Private TextView tvSelected,tvSubscribe,tvFind; 

Private View viewIndicator; 


Private int currentIndex = 0; 
Private int currentSelectId; 


@Override 
Public View onCreateView (LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
getScreenSize (getActivity() ) ;// 获 取 屏 幕 宽 高 


View rootView = inflater.inflate(R.layout.fragment main,null); 
vPager = (ViewPager) rootView.findViewById(R.id.viewpager home); 


SelectedFragment selectedFragment = new SelectedFragment (); 
SubscribeFragment subscribeFragment = new SubscribeFragment (); 
FindFragment findFragment = new FindFragment (); 


list.add(selectedFragment) ;// 添 加 精 选 Fragment 
list.add(subscribeFragment) ;// 添 加 订阅 Fragment 
list.add (findFragment);// 添 加 发 现 Fragment 


adapter=new FragmentAdapter (getActivity() .getSupportFragmentManager () ， 
list); 

vPager .setAdapter (adapter) ;// 设 置 适 配器 

vPager.setOffscreenPageLimit (2) ;// 缓 存 页 数 

vPager.setOnPageChangeListener (pageChangeListener) ;// 改 变 监听 


tvSelected = (TextView) rootView.findViewById(R.id.tv_selected) ;// 精 选 
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tvSubscribe = (TextView) rootView.findViewById(R.id.tv subscribe);// 订 阅 
tvFind = (TextView) rootView.findViewById(R.id.tv find);// 发 现 


tvSelected.setOnClickListener(clickListener); 
tvSubscribe.setOnClickListener(clickListener); 
tvFind.setOnClickListener(clickListener); 


tvSelected.setSelected (true) ;// 默 认 选中 “ 精 选 ” 


viewIndicator = rootView.findViewById (R.id.view indicator);// 指 示 器 View 
initCursorPosition();// 初 始 化 指示 器 位 置 
return rootView; 


vate OnClickListener clickListener = new OnClickListener() { 
@Override 
public void onClick(View v) { 
if (currentSelectId != v.getId()) {// 防 止 重复 点 击 
Switch (v.getId()) { 
case R.id.tv selected: 
VPager.setCurrentIitem(0); 
break; 
case R.id.tv subscribe: 
VPager.setCurrentItem(1) 7 
break; 
case R.id.tv find: 
vPager.setCurrentItem(2); 
break; 
currentSelectId = v.getId(); 


Private void initCursorPosition() { 


/3,0,0,0); 


} 


LayoutParams layoutParams = ViewIndicator.getLayoutParams () 7 
layoutParams.width = screenWidth / 3; 
viewIndicator.setLayoutParams (layoutParams); 


TranslateAnimation animation = new TranslateAnimation(-screenWidth 


animation.setFillAfter (true); 
viewIndicator.startAnimation (animation); 


Private OnPageChangeListener pageChangeListener = new OnPageChangeListener() { 


@Override 

Public void onPageSelected (int index) { 
translateAnimation (index) ;// 移 动 指示 器 
changeTextColor (index) ; // 改 变 文字 颜色 
currentIndex = index;// 设 置 当 前 选中 


Q@Override 
Public void onPageScrolled(int arg0, float argl, int arg2) { 
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animation.setDuration(300) 7 
viewIndicator.startAnimation (animation); 


1 
// 获 取 屏 幕 的 宽 与 高 


Private void getScreenSize(Activity context) { 
DisplayMetrics dm = new DisplayMetrics(); 
context .getWindowManager () .getDefaultDisplay() .getMetrics (dm); 
screenWidth = dm.widthPixels; 
screenHeight = dm.heightPixels; 


@ ”onCreateView: 首先 获取 屏幕 的 宽 与 高 ， 加 载 布局 文件 ， 然 后 初始 化 三 个 Fragment， 添 加 到 
列表 集合 ， 初 始 化 适配器 ， 给 ViewPager 设置 适配器 ,设置 缓存 页 数 ， 设 置 页 面 改变 监听 回 
调 接 口 ， 查 找 项 部 Tab 选项 卡 的 TextView， 默 认 选 中 “ 精 选 "， 最 后 初始 化 指示 器 位 置 。 
clickListener: 如 果 不 是 重复 点 击 ， 根 据点 击 Tab 选项 卡 来 设置 ViewPager 当前 选中 的 页 面 。 
initCursorPosition: 初始 化 当前 指示 器 位 置 。 
pageChangeListener: 在 onPageSelected 处 理 页 面 选择 事件 ， 移 动 指示 器 ， 改 变 Tab 选项 卡 的 
文字 颜色 ， 将 当前 选中 的 位 置 赋值 给 全 局 变量 保存 起 来 。 

@ changeTextColor: 改变 Tab 选项 卡 的 选中 状态 ， 因 为 给 TextView 设置 了 选择 器 ， 所 以 选中 和 
未 选中 状态 决定 了 显示 哪 种 颜色 。 
translateAnimation: 移动 指示 器 ， 产 生 一 个 移动 动画 。 
getScreenSize: 获取 屏幕 的 宽 与 高 。 


10.3.2” 精 选 Fragment 





从 整体 来 看 ， 就 是 一 个 ListView， 顶 部 轮 播 图 是 ListView 的 头 部 。 头 部 轮 播 也 是 用 ViewPager 
来 实现 的 ， 与 开发 者 头条 App 启动 页 的 实现 原理 相似 。 然 后 添加 一 个 定时 器 ， 隔 一 段 时间 设 置 
ViewPager 的 当前 页 面 即 可 。 


这 里 的 图 片 用 的 是 静态 (本 地 ) 的 ， 一 个 商业 App 的 轮 播 图 片 肯定 是 从 服务 器 获取 的 ， 例 
如 真正 开发 者 头条 App 就 是 从 服务 器 获取 图 片 Url。 





fragment_selected.java 是 精 选 Fragment 的 布局 文件 ， 其 中 仅 一 个 ListView: 


<?xml Version="1.0"” encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<ListView 
android:id="@+id/list" 
android:scrollbars="none" 
android:layout_height="wrap_content" 
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android:layout width="match parent"/> 
</LinearLayout> 


fragment_selected_header.java 是 精 选 头 布局 ， 用 来 显示 Banner: 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:1layout width: 
android:1layout heigh 
android:orientation= 






"match parent" 
match parent" 
vertical" > 





<RelativeLayout 
android:layout width="wrap content" 
android:layout height="200dp" > 


<android.support.v4.view.ViewPager 
android:id="@+id/viewpager" 
android:layout width="match parent" 
android:layout height="match parent" /> 


<TextView 
android:id="@+id/tv content" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout marginBottom="10dp" 
android:layout marginLeft="5dp" 
android:text=" 公 众 号 :ansen 666" /> 


<RelativeLayout 


android:layout width: 
android:layout heigh 
android:orientation= 





"fill parent" 
"wrap content" 
vertical” > 








<LinearLayout 


android:id="@+id/viewGroup" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout marginBottom="5dp" 
android:gravity="center horizontal" 
android:orientation="horizontal"/> 





</RelativeLayout> 
</RelativeLayout> 
</LinearLayout> 


SelectedFragment.java 是 精 选 Fragment 的 文件 ， 内 容 如 下 : 


Public class SelectedFragment extends Fragment{ 


private 
private 


private 
private 
Private 


ViewPager viewPager; 
SelectedPagerAdapter selectedPagerAdapter; 


ImageView[] tips;// 底 部 ... 
Timer timer; 
final int CAROUSEL TIME = 3000;// 滚 动 间隔 
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private int currentIndex=0;// 当 前 选中 


Private TextView tvContent; 
private String[] carousePageStr=new String[]{"Android 开发 666", "公众 
号 :Ansen 666", "Python 的 练 手 项 目 有 哪些 值得 推荐 "}; 


private ListView listView; 
private SelectedAdapter selectedAdapter; 


@Override 
public View onCreateView (LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) 1{ 
View rootView = LayoutInflater.from(getRctivity()) .inflate 
(R.layout.fragment selected, null); 


View headView = LayoutInflater.from(getRctivity()) .inflate(R.layout. 
fragment selected header, null); 


tvContent=(TextView) headView.findViewById(R.id.tv content); 
tvContent.setText (carousePageStr[0]); 


viewPager = (ViewPager)headView.findViewById(R.id.viewpager); 
selectedPagerAdapter=new SelectedPagerAdapter(getActivity(), 
carousePagerSelectView); 
viewPager.setOffscreenPageLimit (2); 
ViewPager.setCurrentItem(0) 7 
viewPager.setOnPageChangeListener (onPageChangeListener); 
viewPager.setAdapter (selectedPagerAdapter); 


ViewGroup group = (ViewGroup) headView.findViewById(R.id.viewGroup); 
// 初始 化 底部 显示 控件 
tips = new ImageView[3]; 
for (int i = 0; i < tips.length; i++){ 
ImageView imageView = new ImageView (getActivity()); 


if (i == 0) { 
imageView.setBackgroundResource (R.drawable.page indicator focused); 
} else { 


imageView.setBackgroundResource (R.drawable.page indicator unfocused); 

} 
tips[i] = imageView; 
LinearLayout .LayoutParams layoutParams = new LinearLayout. 
LayoutParams (new ViewGroup.LayoutParams (LayoutParams .WRAP 
CONTENT, LayoutParams .WRAP CONTENT)); 
layoutParams .leftMargin = 10;// 设置 指示 器 ItemView ( 横 线 ) 的 左边 距 
layoutParams .rightMargin = 10;// 设置 指示 器 ItemView ( 横 线 ) 的 右边 距 
group.addView (imageView, layoutParams); 

} 


timer = new Timer (true);// 初 始 化 计时 器 
timer.schedule (task，0，CAROUSEL TIME) ;// 延 时 0ms 后 执行 , 3000ms 执行 一 次 


listView=(ListView) rootView.findViewById(R.id.list); 
listView.addHeaderView (headView); 

listView.setAdapter (selectedAdapter=new SelectedAdapter (getActivity())); 
return rootView; 
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} 


Private ICarousePagerSelectView carousePagerSelectView=new ICarousePagerSelectView() { 
@Override 
Public void carouseSelect (int index) { 
Toast .makeText (getActivity(), carousePageStr[index], 
Toast .LENGTH SHORT) .show(); 
} 
] 7 


TimerTask task = new TimerTask() { 
public void run() { 
handler.sendEmptyMessage (CAROUSEL TIME); 
| 
1 


Private Handler handler=new Handler(){ 
Public void handleMessage (Message msg) { 
switch (msg.what) { 


Case CAROUSEL TIME: 
if(currentIndex>=tips.length-1){// 已 经 滚动 到 最 后 , 从 第 一 页 开始 


ViewPager.setCurrentItem(0) 7 
}else{// 开 始 下 一 页 


ViewPager.setCurrentItem(CurrentIndex+1) 7 


} 
break; 


@Override 

Public void onDestroy(){ 
task.cancel() 
System.exit(0) 7 

上 


Private OnPageChangeListener onPageChangeListener=new OnPageChangeListener() { 


@Override 
public void onPageSelected (int index) { 
tvContent .setText (carousePageStr [index]); 





setImageBackground (index) ;// 改变 圆 点 的 切换 效果 
currentIindex=index; 
} 
@Override 
Public void onPageScrolled (int arg0, float argl, int arg2){} 
@Override 


Public void onPageScrollStateChanged(int arg0) {} 
En 





/** 

* 改变 圆 点 的 切换 效果 

* @param selectItems 
a 


Private void setImageBackground (int selectItems) { 
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for (int i = 0; i < tips.length; i++) { 
if (i == selectItems) { 
tips [i] .setBackgroundResource (R.drawable.page indicator focused); 
} else { 
tips [i] .setBackgroundResource (R.drawable.page indicator unfocused); 
} 


@ onCreateView: 设置 布局 文件 ， 初 始 化 头 文件 ， 初 始 化 显示 广告 的 ViewPager， 设 置 适配器 ， 
给 Banner 增加 滚动 状态 , 初始 化 计时 器 , 3 秒 执行 一 次 。 给 文章 列表 的 ListView 添加 头 文件 ， 
并 且 设置 适配器 。 

carousePagerSelectView: Banner 的 项 目 点 击 回调 接口 。 

task: 计时 器 回调 ， 给 handler 发 送 一 个 消息 。 

handler: 更 新 Banner 的 选中 位 置 ， 显 示 下 一 个 Banner。 

onDestroy: 关闭 计时 器 。 

onPageChangeListener: 显示 广告 的 ViewPager 页 面 改变 监听 。 

setImageBackground: 广告 选中 状态 的 变化 。 


© 0 0 © © 9。 


有 关 显 示 广 告 ， 前 面 已 讲 过 多 次 了 ， 这 里 就 不 贴 出 SelectedPagerAdapter 的 代码 了 。 
接 下 来 ， 看 看 精 选 文章 的 SelectedAdapterjava 文件 : 


Public class SelectedAdapter extends BaseAdapter{ 
Private LayoutInflater inflater; 
Private List<SelectedArticle> selectedArticles; 


public SelectedAdapter (Context context){ 
inflater = LayoutIinflater.from(context); 
selectedArticles=new ArrayList<SelectedArticle>(); 
initData(); 

} 


Private void initData(){ 
for (int i=0;i<50;i++){ 
SelectedArticle selectedArticle=new SelectedArticle(i, "Android 开 
6m 
selectedArticles.add (selectedArticle); 
} 
} 


@Override 
public int getCount() { 

return selectedArticles.size(); 
上 


@Override 

Public Object getItem(int position) { 
return SelectedRrticles .get (Position) 7 

} 


@Override 
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public long getItemId (int position) { 
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return selectedArticles.get (position) .getId() 


@Override 
public View getView(int position, View convertView, ViewGroup parent){ 


3. 


ViewHolder holder; 
if (convertView == null) { 


convertView = inflater.inflate(R.layout.fragment selected item, null); 
holder = new ViewHolder () 7 

holder.title = (TextView) convertView.findViewById(R.id.tv title); 
holder.like = (TextView) convertView.findViewById(R.id.tv like); 
holder.comment = (TextView) convertView.findViewById(R.id.tv comment); 
convertView.setTag (holder); 


} else { 


holder = (ViewHolder) convertView.getTag(); 


SelectedArticle selectedArticle=selectedArticles.get (position); 
holder.title.setText (selectedArticle.getTitle()); 
holder.like.setText (""+selectedArticle.getLikeNumber ()); 
holder.comment .setText (""+selectedArticle.getCommentNumber ()); 
return convertView; 


Private class ViewHolder { 


Private TextView title; 
Private TextView like; 
private TextView comment; 


和 其 他 适配器 没 啥 区 别 ， 继 承 BaseAdapter， 重 写 四 个 方法 ， 前 面 我 们 已 经 写 了 很 多 遍 了 。 


SelectedArticle 类 跟 Item 布局 文件 代码 比较 简单 ， 就 不 逐一 贴 出 代码 了 ， 大 家 下 载 源 代 码 之 后 


Ea 





10.4 开发 者 头条 首页 优化 


Google 在 2015 年 的 IO 大 会 上 给 我 们 带 来 了 更 加 详细 的 Material Design 设计 规范 。 同 时 ， 也 
节 来 了 全 新 的 Android Design Support 库 。 在 这 个 Support 库 中 ，Google 提供 了 更 加 规范 的 MD 设 


计 风 格 的 控件 。 最 重要 的 是 , Android Design Support 库 的 兼容 性 更 广 , 直接 可 以 向 下 兼容 到 Android 
2.2。 这 不 得 不 说 是 一 个 良心 之 作 。 


下 面 就 用 Design 包 重 写 首 页 ， 效 果 如 图 10-4 所 示 。 
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全 oa 2) 


选 自 Android: 










Android 开 发 666 
1 导 1 


Android 开 发 665 


Android 开 发 666 


3 过 landroid Android 开 发 666 


Android 开 发 666 Android 开 发 666 的 分 人 





104 重 写 首页 后 的 运行 效果 图 


单 从 效果 图 上 看 ， 和 前 面 的 首页 没有 太 大 变化 ， 唯 一 变化 的 就 是 列表 上 拉 时 会 隐藏 标题 栏 ， 
其 实 里 面 的 代码 几乎 重 写 了 一 遍 ， 已 经 使 用 了 Android Design Support 库 。 





10.4.1 ”需要 在 线 依赖 


compile 'com.android.support:design:22.2.0' 
compile '‘'com.android.support:recyclerview-v7:22.2.0' 


为 什么 多 了 一 个 recyclerview 依赖 呢 ? 因为 在 第 3 版 中 使 用 的 是 ListView 来 实现 文章 列表 ,而 
在 这 个 版 本 中 改 用 Recyclerview 来 实现 文章 列表 。 


10.4.2 ”标题 栏 和 三 个 切换 选项 卡 


修改 fragment_main.xml 首页 Fragment 布局 文件 : 


<?xml version="1.0" encoding="utf-8"?> 
<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/coordinatorLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support .design.widget.AppBarLayout 
id="@+id/appBarLayout™" 

ayout width="match Parent" 
android:layout height="wrap content"> 





<android.support .v7 .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent™" 
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android:layout height="wrap content" 
android:background="@color/launcher item select" 
app:layout scrollFlags="scroll|enterAlways" 


app:titleTextAppearance="@style/ansenTextTitleAppearance"/> 


<android.support.design.widget.TabLayout 
android:id="@+id/tabLayout" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:background="@color/main color" 
app:tabIndicatorColor="@color/white normal" 
app:tabIndicatorHeight="2dp" 
app:tabSelectedTextColor="@color/main title text select" 


app:tabTextAppearance="@style/AnsenTabLayoutTextAppearance" 


app:tabTextColor="@color/main title text normal" /> 
</android.support .design.widget.AppBarLayout> 


<android.support .v4.view.ViewPager 
android:id="@+id/viewPager" 
android:layout width="match parent" 
android:layout height="match Parent" 
app:layout behavior="@string/appbar scrolling view behavior" 
</android.support.design.widget.CoordinatorLayout> 


人 


最 外 层 是 CoordinatorLayout， 其 中 主要 分 为 两 块 : AppBarLayout 和 ViewPager (AppBarLayout 


中 包含 标题 栏 的 Toolbar+TabLayout，ViewPager 用 来 切换 Fragment 显示 ) 。 


有 关 标 题 栏 ， 之 前 引用 过 一 个 布局 文件 ， 现 在 改 成 了 Toolbar， 仅 一 个 控件 就 够 了 。 


跟 得 上 时 代 ， 规 格 提高 了 ， 更 加 规范 的 MD 设计 风格 。 

控件 变 少 了 ， 现 在 不 管 多 少 个 Tab 都 用 一 个 TabLayout 控件 。 
指示 器 的 滑动 功能 ， 只 需 在 xml 中 添加 一 个 属性 即 可 。 
隐藏 显示 标题 栏 很 方便 ， 只 需要 在 布局 文件 中 改动 即 可 。 

为 了 使 Toolbar (标题 栏 ) 产生 滑动 效果 ， 必 须 做 到 如 下 三 点 : 
CoordinatorLayout 作为 布局 的 父 布局 容器 。 

给 需要 滑动 的 组 件 设置 app:layout scrollFlags= "scrolllenterAlways" 属 性 。 
滑动 的 组 件 必须 是 AppBarLayout 顶部 组 件 。 

给 滑动 的 组 件 设置 app:layout_behavior 属性 。 

ViewPager 显示 的 Fragment 中 不 能 是 ListView， 必 须 是 RecyclerView。 


接 下 来 修改 MainFragment.java 代码 : 


三 个 切换 


的 选项 卡 之 前 用 的 是 三 个 TextView， 现 在 改 成 了 TabLayout。 更 换 之 后 有 如 下 一 些 优点 : 





初始 化 Toolbar， 加 载 菜 单 布局 ， 实 现 标题 栏 的 自 定义 。 给 NavigationIcon 设置 点 避 


下 面 贴 出 相关 的 代码 ， 有 关 菜 单 的 布局 文件 就 不 贴 出 来 了 ， 因 为 相对 比较 简单 。 


Toolbar toolbar = (Toolbar) rootView.findViewById(R.id.toolbar); 
toolbar.inflateMenu (R.menu.ansen toolbar menu); 
toolbar.setNavigationIcon (R.mipmap.ic menu white);// 设 置 导 航 图 标 
toolbar.setTitle ("关注 公众 号 [Android 开发 者 666]"); 


和 事件 等 。 
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toolbar .setTitleTextColor (getResources () .getColor (android.R.color.white)); 
toolbar.setNavigationOnClickListener (onClickListener);// 导 航 图 标点 击 


导航 图 标点 击 事件 处 理 ， 当 我 们 点 击 导航 图 标 时 ， 应 该 打开 左 侧 菜 单 栏 ， 但 是 MainFragment 
是 没有 mDrawerLayout 对 象 的 ， 只 有 MainActivity 才 有 ， 于 是 我 们 通过 接口 方式 调用 ， 在 onClick 
方法 中 调用 drawerListener.open() 方 法 打开 导航 栏 。 
Private View.OnClickListener onClickListener=new View.OnClickListener(){ 
@Override 
Public void onClick(View view) { 


if(drawerListener!=nul1)1{ 
drawerListener.open(); 








} 


drawerListener 对 象 是 创建 MainFragment 时 通过 构造 方法 传 参 带 过 来 的 。MainFragment 构造 
方法 代码 如 下 : 
private MainActivity.MainDrawerListener drawerListener; 
public MainFragment (MainActivity.MainDrawerListener drawerListener){ 
this.drawerListener=drawerListener; 
1 
接 下 来 我 们 看 MainActivity 代码 做 了 什么 改动 ， 首 先 增加 一 个 接口 : 


public interface MainDrawerListener{ 
public void open();// 打 开 Drawer 
} 


然后 用 内 部 类 方式 实现 这 个 接口 ， 当 open 方法 调用 时 打开 左 侧 菜单 栏 : 


Private MainDrawerListener drawerListener=new MainDrawerListener() { 
@Override 
public void open() { 
mDrawerLayout .openDrawer (Gravity.LEFT); 
} 
] 
还 有 最 后 一 步 ， 初 始 化 Fragment 时 将 MainDrawerListener 对 象 传递 过 去 ， 这 样 MainFragment 
持 有 MainActivity 的 MainDrawerListener 对 象 ， 当 在 MainFragment 调用 open 方法 时 , MainActivity 
中 drawerListener 的 open 方法 调用 ， 然 后 打开 左 侧 菜 单 栏 。 


mainFragment=new MainFragment (drawerListener); 


继续 修改 MainFragment 代码 ， 在 onCreateView 方法 中 给 ViewPager 设置 Fragment 适配器 ， 
TabLayout 绑 定 ViewPager， 这 样 ViewPager 滑动 时 或 者 选择 选项 卡 时 都 会 切换 Fragment。 
VPager = (ViewPager) rootView.findViewById(R.id.viewPager); 


vPager.setOffscreenPageLimit (2) ;// 设 置 缓存 页 数 
VPager.setCurrentIitem(0); 


FragmentAdapter pagerAdapter = new FragmentAdapter (getRActivity() . 
getSupportFragmentManager () ); 
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SelectedFragment selectedFragment=new SelectedFragment (); 
SubscribeFragment subscribeFragment=new SubscribeFragment (); 
FindFragment findFragment=new FindFragment (); 


pagerAdapter.addFragment (selectedFragment, " 精 先 ") ; 
pagerAdapter.addFragment (subscribeFragment, "订阅 "); 
pagerAdapter.addFragment (findFragment, "发 现 ") ; 


VPager.setAdapter (pagerAdapter); 


TabLayout tabLayout = (TabLayout) rootView.findViewById(R.id.tabLayout); 
tabLayout .setupWithViewPager (vPager); 


10.4.3 分析 TabLayout 切换 源 代码 


我 们 调用 TabLayout 的 setupWithViewPager(ViewPager viewPager) 方 法 时 ， 其 实在 内 部 就 给 
ViewPager 设置 了 页 面 滑 动 监听 ， 不 信 你 看 setupWithViewPager 方法 源 代码 : 


Public void setupWithViewPager (ViewPager viewPager) { 
PagerAdapter adapter = viewPager.getAdapter (); 
if(adapter == null) { 

throw new IllegalArgumentException("ViewPager does not have a PagerAdapter 
set"); 
} else { 
this.setTabsFromPagerAdapter (adapter); 
ViewPager.addOonPageChangeListener (new TabLayout. 
TabLayoutOnPageChangeListener (this)); 
this .setOnTabSelectedListener (new TabLayout. 
ViewPagerOnTabSelectedListener (viewPager) ) 
} 
} 


从 上 面 代码 中 可 以 看 到 主要 设置 了 两 个 监听 函数 。 先 讲述 第 一 个 监听 , 在 TabLayout 中 有 一 个 
静态 类 TabLayoutOnPageChangeListener， 用 来 处 理 ViewPager 改变 状态 切换 或 者 增加 〉 监 听 。 


viewPager.addOnPageChangeListener (new TabLayout. 
TabLayoutOnPageChangeListener (this)); 


TabLayoutOnPageChangeListener 实现 了 ViewPager 的 OnPageChangeListener 接口 ， 在 
onPageSelected 方法 中 调用 了 当前 选中 的 某 个 选项 卡 的 select 方法 。 


public void onPageSelected (int Position) { 
TabLayout tabLayout = (TabLayout)this.mTabLayoutRef.get() 
if(tabLayout != null) { 
tabLayout .getTabAt (Position) .select (); 
1 


} 
然后 继续 跟踪 TabLayout.Tab 类 的 select0 查 看 是 如 何 实现 的 。 我 们 可 以 看 到 又 调用 了 父 类 
(TabLayout) 的 selectTab。 


Public void select() { 
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this.mParent .selectTab (this) 
ji 
然后 跟踪 selectTab 方法 ， 这 里 大 家 可 以 看 到 参数 是 某 个 具体 Tab 对 象 ， 首 先 判断 是 不 是 当前 
的 选项 卡 ， 如 果 不 是 ， 就 设置 选择 当前 的 选项 卡 ， 并 开启 选项 卡 的 滑动 动画 效果 。 
void selectTab (TabLayout .Tab tab) { 
if(this.mSelectedTab == tab) { 
if(this.mSelectedTab != null) { 
if(this.mOonTabSelectedListener != null) { 
this .moOonTabSelectedLi stener .onTabReselected (this .mSelectedTab); 
} 


this .animateToTab (tab.getPosition()); 
} 


} else { 
int newPosition = tab != null?tab.getPosition():-1; 
this.setSelectedTabView (newPosition); 
if((this.mSelectedTab == null || this.mSelectedTab.getPosition() == 
-1) && newPosition != -1) { 
this.setScrollPosition (newPosition, 0.0F, true); 
jj else { 
this .animateToTab (newPosition); 
4 


if(this.mSelectedTab != null && this.mOnTabSelectedListener != null) { 
this .monTabSelectedListener.onTabUnselected (this .mSelectedTab); 


} 


this.mSelectedTab = tab; 
if(this.mSelectedTab != null && this.mOnTabSelectedListener != null) { 
this.mOonTabSelectedListener.onTabSelected (this.mSelectedTab); 


} 


| 
上 面 的 代码 就 不 逐一 解释 了 ， 直 接 查 看 最 下 面 的 两 行 代码 ， 调 用 选项 卡 的 选择 方法 : 


if(this.mSelectedTab != null && this.mOonTabSelectedListener != null) { 
this.monTabSelectedListener.onTabSelected (this.mSelectedTab); 


} 
Tab 选择 监听 的 接口 : 


public interface OnTabSelectedListener { 
void onTabSelected (TabLayout .Tab varl); 
void onTabUnselected (TabLayout .Tab varl); 
void onTabReselected (TabLayout .Tab varl) 
WE 


在 TabLayout 内 部 实现 了 OnTabSelectedListener 接口 ， 在 onTabSelected 方法 中 调用 了 
ViewPager 的 setCurrentItem()， 这 个 方法 大 家 应 该 都 熟悉 吧 ， 就 不 多 做 解释 了 。 


Public static class ViewPagerOnTabSelectedListener implements 
TabLayout .OnTabSelectedListener { 
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Private final ViewPager mViewPager7 


Public ViewPagerOnTabSelectedListener (ViewPager viewPager) { 
this.mViewPager = viewPager; 
上 


public void onTabSelected (TabLayout .Tab tab) { 
this.mViewPager.setCurrentItem(tab.getPosition()); 


Public void onTabUnselected (TabLayout .Tab tab) { 


Public void onTabReselected (TabLayout .Tab tab) { 
3 
1 


上 面 讲 的 是 第 一 个 监听 ， 也 就 是 ViewPager 滑动 的 时 候 如何 切 换 项 目 、 如 何 切换 选项 卡 。 现 
在 来 说 第 二 个 监听 ， 就 是 点 击 选择 选项 卡 时 如 何 切换 。 继 续 回 到 TabLayout 的 
setupWithViewPager(ViewPager viewPager) 方 法 。 

this.setonTabSelectedListener (new TabLayout.ViewPagerOonTabSelectedListener 
(viewPager)); 

看 到 ViewPagerOnTabSelectedListener 类 是 不 是 很 熟悉 ?其 实 就 是 第 一 种 方法 最 后 调用 的 那个 
类 ， 因 为 点 击 某 个 选项 卡 时 ， 选 项 卡 切换 的 代码 已 经 运行 ， 所 以 这 里 只 需要 设置 ViewPager 当前 选 
中 的 项 目 即 可 。 


10.4.4” 精 选 文 章 列表 控件 从 ListView 替换 成 RecyclerView 


RecyclerView 是 AndroidL 版 本 中 新 增 的 一 个 用 来 取代 ListView 的 SDK， 灵 活性 与 可 替代 性 
比 listview 更 好 。 当 然 新 的 控件 在 使 用 过 程 中 会 碰 到 一 些 问题 ， 但 是 相信 Google 会 努力 解决 这 些 bug。 
修改 fragment_selected.xml 布局 文件 ， 将 ListView 替换 成 RecyclerView。 


<?xml version="1.0" encoding="utf-8"?> 
<android.support.v7.widget.RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" /> 


然后 修改 布局 文件 对 应 的 SelectedFragment.java 代码 : 
(1) 在 oncreate 方法 中 查找 RecyclerView， 设 置 布局 管理 器 、 适 配器 ， 设 置 headerView。 


recyclerView= (RecyclerView) rootView.findViewById (R.id.recyclerView) 
LinearLayoutManager mLayoutManager = new LinearLayoutManager (getRActivity()， 
LinearLayoutManager .VERTICAL, false); 
recyclerView.setLayoutManager (mLayoutManager); 

selectedAdapter=new SelectedAdapter (); 
recyclerView.setAdapter (selectedAdapter); 

selectedAdapter.setHeaderView (headView); 
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(2) 修改 适配器 SelectedAdapterjava: 


Public class SelectedAdapter extends RecyclerView.Adapter { 
Private List selectedArticles; 

Public static final int TYPE HEADER = 0; 

Public static final int TYPE NORMAL = 17 

private View mHeaderView;// 头 文件 View 


Public SelectedAdapter() { 
selectedArticles = new ArrayList<SelectedArticle>(); 
initData(); 

} 


private void initData() { 
For (int dm On 1 < SO THE) 
SelectedArticle selectedArticle = new SelectedArticle (i,， "Android 开发 
i 
selectedArticles.add(selectedArticle); 





666", i, i, 


} 


Public void setHeaderView (View headerView) { 
mHeaderView = headerView; 
notifyItemInserted(0); 

i 


public View getHeaderView() { 
return mHeaderView; 
} 


@Override 
public int getItemViewType (int position) { 
if (mHeaderView == null) 
return TYPE NORMAL; 
if (position == 0) 
return TYPE HEADER; 
return TYPE NORMAL; 
有 


@Override 
public SelectedViewHolder onCreateViewHolder (ViewGroup parent, int viewType) { 
if (mHeaderView != null && viewType TYPE HEADER) {// 头 类 型 





return new SelectedViewHolder (mHeaderView); 
} 
View layout = LayoutIinflater.from(parent .getContext ()) .inflate 
(R.layout.fragment selected item, parent, false); 
return new SelectedViewHolder (layout); 
} 


@Override 
public void onBindViewHolder (SelectedViewHolder holder,int position){ 
if(getIitemViewType (position) == TYPE HEADER) 
return; 


SelectedArticle selectedArticle = selectedArticles.get (position); 
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} 


holder.title.setText (selectedArticle.getTitle()); 
holder.like.setText("" + selectedArticle.getLikeNumber ()); 
holder.comment .setText ("" + selectedArticle.getCommentNumber ()); 


@Override 
public long getItemId(int position) { 


} 


return selectedArticles.get (position) .getId(); 


@Override 
public int getItemCount() { 


} 


return selectedArticles.size(); 


class SelectedViewHolder extends RecyclerView.ViewHolder { 


I 
} 


private TextView title; 
private TextView like; 
private TextView comment; 


public SelectedViewHolder (View view) { 
super (view); 
if(itemView == mHeaderView) 
return; 
title = (TextView) view.findViewById(R.id.tv title); 
like = (TextView) view.findViewById(R.id.tv like); 
comment = (TextView) view.findViewById(R.id.tv comment); 


适配器 继承 自 RecyclerView.Adapter， 重 写 5 个 方法 。 在 构造 方法 中 初始 化 50 条 文章 对 象 。 


setHeaderView: 设置 头 布局 ， 并 且 指 定 更 新 RecyclerView 第 一 条 记录 。 

getltemViewType: 如 果 头 View 不 为 空 并 且 是 第 一 条 记录 ， 就 返回 头 布局 的 类 型 。 如 果 是 普 
通 Item， 就 返回 普通 Item 的 类 型 。 

onCreateViewHolder: 创建 每 一 行 的 View， 如 果 是 头 布局 就 显示 传 入 进来 的 头 View; 如 果 是 
普通 类 型 ， 就 通过 LayoutInflaterinflate 方法 创建 普通 布局 的 View。 

onBindViewHolder: 给 每 一 行 的 View 绑 定 数据 。 

getItemCount: 要 显示 的 条 数 。 


10.5 ”RecyclerView 实现 下 拉 刷 新 和 和 上 拉 加 载 更 多 


将 RecyclerView 下 拉 刷 新 与 上 拉 加 载 更 多 加 入 到 开发 者 头条 App 中 。 这 样 首页 的 精 选 列表 就 
能 支持 分 页 了 。 在 实际 工作 中 ， 大 部 分 列表 页 都 需要 支持 分 页 加 载 。 
效果 如 图 10-5 所 示 。 
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图 10-5 实现 下 拉 刷 新 和 上 拉 加 载 更 多 的 精 选 列表 


10.5.1 实现 步骤 


步骤 014 查找 一 个 带 有 下 拉 刷 新 和 上 拉 加 载 更 多 的 RecyclerView 开源 库 。 

步 野 024 下 载 后 运行 一 下 ， 然 后 看 看 是 不 是 我 们 需要 的 功能 ， 觉 得 不 错 就 把 模块 依赖 进来 ， 
整合 主 项 目 。 

步骤 034 整合 进来 之 后 ,肯定 需要 进行 适当 修改 ,例如 本 例 就 产生 滑动 冲突 ,有 多 个 headView 
等 问题 。 























10.5.2 ”实现 详解 


1. 查找 RecyclerView 下 拉 刷 新 和 上 拉 加 载 的 开源 库 


查找 开源 项 目的 首选 是 Github， 搜 索 一 下 ， 会 发 现 有 一 大 堆 。 如 果 效 果 图 是 想 要 的 功能 ， 再 
查找 排名 靠 前 、 收 藏 比较 多 的 项 目 。 这 里 查找 的 项 目 是 CommonPullToRefresh， 支 持 ListView、 
RecyclerView、GridView、SwipeRefreshLayout 等 常用 控件 。 运 行 了 一 下 演示 文件 ， 没 有 发 现 什么 
问题 ， 挺 好 用 的 。 

刷新 库 的 Github 地 址 如 下 : 

https://github.com/Chanven/CommonPullToRefresh 


2. 将 库 添加 到 项 目 中 


步 肾 014 将 .module 导入 进来 ,然后 主 项 目 依赖 一 下 。 有 不 会 的 读者 可 查看 本 书 第 1 章 Android 
Studio 如 何 导入 模块 、 添 加 项 目 依赖 。 
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步骤 02 修改 SelectedFragment。 首 先 查看 布局 文件 的 变化 ， 在 RecyclerView 外 面包 衰 了 自 
定义 的 一 个 类 PtrClassicFrameLayout， 内 部 实现 了 下 拉 刷 新 和 上 拉 加 载 。 还 可 以 设置 自 定义 属性 ， 
这 些 属 性 的 功能 就 不 逐一 解释 了 ， 有 兴趣 的 读者 可 以 点 击 Github 上 的 链接 ， 讲 解 得 很 详细 。 











修改 fragment_selected.xml 文件 : 


<?xml Version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<com.chanven.1lib.cptr.PtrClassicFrameLayout xmlns:cube ptr= 
"http://schemas.android.com/apk/res-auto" 

android:id="@+id/test recycler view frame" 
android:layout width="match parent" 
android:layout height="match Parent" 
android:background="#f£0f0f0" 
cube ptr:ptr duration to close="200" 
cube ptr:ptr duration to close header="700" 
cube ptr:ptr keep header when refresh="true" 
cube Pull to fresh="false" 
cube ratio of header height to refresh="1.2" 
cube ptr:ptr resistance="1.8"> 





<android.support .v7 .widget.RecyclerView 
android:id="@+id/test recycler view" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@android:color/white"/> 
</com.chanven.1ib.cptr.PtrClassicFrameLayout> 
</LinearLayout> 


接 下 来 查看 SelectedFragment.java。 在 onCreateView 中 查找 PtrClassicFrameLayout 控件 ， 然 后 
调用 init 方 法 。 
@Override 
Public View onCreateView (LayoutInflater inflater, ViewGroup container,Bundle 
savedInstanceState)1{ 


View rootView = LayoutInflater.from(getActivity()) .inflate(R.1layout. 
fragment selected, null); 


ptrClassicFrameLayout = (PtrClassicFrameLayout) 
rootView.findViewById(R.id.test recycler view frame); 
mRecyclerView = (RecyclerView) 
rootView.findViewById(R.id.test recycler view); 
mRecyclerView.setLayoutManager (new LinearLayoutManager (getActivity())); 


init()? 
return rootView; 
} 
接 下 来 看 init 方法 如 何 实现 。 首 先 初始 化 适配器 ， 然 后 用 RecyclerAdapterWithHF 类 对 适配器 
做 包装 ， 这 个 包装 类 中 封装 了 添加 头 部 的 方法 ， 因 为 RecyclerView 不 支持 添加 Header， 需 要 自己 
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手动 去 实现 。 最 后 设置 了 下 拉 刷 新 和 上 拉 加 载 的 监听 。 


Private void init() { 
// 初 始 化 适配器 
selectedAdapter = new SelectedRecyclerAdapter (getActivity()); 
// 对 适配器 进行 封装 
mAdapter = new RecyclerAdapterWithHF (selectedAdapter); 
// 将 滚动 Banner 加 入 头 部 
mAdapter.addCarouse (initCarouselHead ()); 
mRecyclerView.setAdapter (mAdapter); 
PtrClassicFrameLayout .setPtrHandler (ptrDefaultHandler);// 设 置 下 拉 监 听 
ptrClassicFrameLayout.setOnLoadMoreListener (onLoadMoreListener); 
// 设 置 上 拉 监 听 
PtrClassicFrameLayout .setLoadMoreEnable (true) ;// 设 置 可 以 加 载 更 多 
} 


在 init 方法 中 还 调用 了 initCarouselHead 方法 , 这 个 方法 初始 化 了 Banner, 把 Banner 布局 View 
返回 ， 用 来 作为 RecyclerView 的 头 部 。 


private View initCarouselHead(){// 初 始 化 
View headView = LayoutInflater.from(getRctivity()) .inflate 
(R.layout.fragment selected header,mRecyclerView, false) 7 


tvContent= (TextView) headView.findViewById(R.id.tv content); 
tvContent .setText (carousePageStr[0]) 


viewPager = (ViewPager)headView.findViewById(R.id.viewpager) 

selectedPagerAdapter=new SelectedPagerAdapter (getRctivity()， 
CarousePagerSelectView); 

viewPager.setOffscreenPageLimit (2) ? 

ViewPager .setCurrentItem(0) 

viewPager.addOnPageChangeListener (onPageChangeListener); 

viewPager.setAdapter (selectedPagerAdapter); 


ViewGroup group = (ViewGroup) headView.findViewById(R.id.viewGroup); 
// 初始 化 底部 显示 控件 
tips = new ImageView[3]; 
for (int i = 0; i < tips.length; i++){ 
ImageView imageView = new ImageView (getActivity()); 
if (i == 0) { 
imageView.setBackgroundResource (R.mipmap.page 
indicator focused); 
} else { 
imageView.setBackgroundResource (R.mipmap .page 
indicator unfocused); 
| 


tips[i] = imageView; 

LinearLayout .LayoutParams layoutParams = new LinearLayout. 
LayoutParams (new LayoutParams (LayoutParams .WRAP CONTENT, 
LayoutParams .WRAP CONTENT)); 

layoutParams .leftMargin = 10;// 设置 圆 点 View 的 左边 距 

layoutParams.rightMargin = 10;// 设置 圆 点 View 的 右边 距 

group.addView (imageView, layoutParams); 
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1 


timer = new Timer (true) ;// 初 始 化 计时 器 
timer.schedule (task，0，CRROUSEL TIME) ; // 延 时 0ms 后 执行 , 3000ms 执行 一 次 


return headView; 


接 下 来 查看 RecyclerView 适配器 SelectedRecyclerAdapterjava 代码 。 适 配器 前 面 已 经 学 习 了 
很 多 遍 了 ， 不 做 解释 : 


public class SelectedRecyclerAdapter extends RecyclerView.Adapter 
<RecyclerView.ViewHolder> { 

private List<SelectedArticle> selectedArticles; 

Private LayoutIinflater inflater; 


public SelectedRecyclerAdapter (Context context) { 
super (); 
inflater = LayoutInflater.from(context); 


selectedArticles = new ArrayList<SelectedArticle>(); 
initData(); 
证 


Private void initData() { 
fo0r (4Dt LE = OF TL < "10 L1H) A 
SelectedArticle selectedArticle = new SelectedArticle(i, "Android 
漠 必 66m Ty nn) 
selectedArticles.add (selectedArticle); 


Public void loadMore (int page) { 
For (Ine dm OF de on tt 
SelectedArticle selectedArticle = new SelectedArticle (i, "第 " + page 
页 数据 mn) 
selectedArticles.add(selectedArticle); 
} 
} 


public void getFirst() { 
selectedArticles.clear (); 
initData(); 

} 


@Override 
public int getItemCount () { 

return selectedArticles.size(); 
} 


QOverride 
Public void onBindViewHolder (RecyclerView.ViewHolder viewHolder, int 
position) { 
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SelectedRecyclerHolder holder = (SelectedRecyclerHolder) viewHolder; 


SelectedArticle selectedArticle = selectedArticles.get (position); 
holder.title.setText (selectedArticle.getTitle()); 
holder.like.setText("" + selectedArticle.getLikeNumber ()); 
holder.comment .setText ("" + selectedArticle.getCommentNumber ()); 

1 


@Override 
public RecyclerView.ViewHolder onCreateViewHolder (ViewGroup viewHolder, 
int position) { 
View view = inflater.inflate(R.layout.fragment selected item, null); 
return new SelectedRecyclerHolder (view); 


} 


public class SelectedRecyclerHolder extends RecyclerView.ViewHolder { 
private TextView title;// 标 题 
Private TextView like;// 喜 欢 数 量 
Private TextView comment;// 评 论 数量 


Public SelectedRecyclerHolder (View view) { 
super (view); 
title = (TextView) view.findViewById(R.id.tv title); 
like = (TextView) view.findViewById(R.id.tv like); 
comment = (TextView) view.findViewById(R.id.tv comment); 


步骤 03 解决 整合 进来 的 问题 。 





滑动 冲突 : 当 上 拉 到 顶部 将 标题 栏 挤 出 屏幕 外 时 ， 再 进行 下 拉 会 触发 RecyclerView 的 下 拉 事 
件 ， 正 确 的 情况 应 该 是 显示 标题 栏 。 
@ ”RecyclerView 下 拉 刷 新 时 先 判断 标题 栏 是 否 显示 。 如 果 标 题 栏 没有 显示 ， 则 不 处 理 。 
e@ ”AppBarLayout 有 一 个 addOnOffsetChangedListener 方法 ， 在 AppBarLayout 的 布局 偏 移 量 发 生 
改变 时 被 调用 。 


在 MainFragment 中 进行 监听 : 


apPBarLayout= (APPBarLayout) rootView.findViewById(R.id.appBarLayout); 
apPBarLayout .addOonOffsetChangedListener (onOffsetChangedListener) 


然后 在 回调 函数 中 将 值 赋 给 SelectedFragment: 


Private APPBarLayout .OnOffsetChangedListener onOffsetChangedListener=new 
AppBarLayout .OnOffsetChangedListener() { 
@Override 
Public void onOffsetChanged (AppBarLayout appBarLayout, int i){ 
//i>=0 ”标题 栏 完全 显示 
selectedFragment .setPullRefresh (i>=0); 
System.out.println("mi 值 :"+i); 
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在 SelectedFragment 中 ， 继 续 将 值 传 给 PtrFrameLayout: 


Public void setPull1Refresh (boolean pullRefresh) { 
ptrClassicFrameLayout.setPullRefresh (pullRefresh); 
} 


在 PtrFrameLayout 中 用 一 个 实例 变量 接收 这 个 值 : 


private boolean pullRefresh=true; 


Public void setPullRefresh (boolean pullRefresh) { 
this.pullRefresh = pullRefresh; 


找到 PtrFrameLayout 类 的 dispatchTouchEvent 事件 ， 这 个 方法 是 处 理 屏 幕 触 摸 事 件 的 。 


override 
Public boolean dispatchTouchEvent (MotionEvent e) { 
if (!isEnabled() || mContent == null || mHeaderView == null) { 


System.out .println ("都 是 空 的 Se 和 
return dispatchTouchEventSupper (e); 
} 
int action = e.getAction(); 
switch (action) { 
case MotionEvent.ACTION UP: 
System.out .println(" 弹 起 ..."); 
case MotionEvent.ACTION CANCEL: 
System.out.printin ("取消 ..."); 
WMA if(pullRefresh){ 
mpPtrIindicator.onRelease(); 
if (mPtrIndicator.hasLeftStartPosition()) { 
if (DEBUG) { 


PtrCLog.d(LOG TAG, "call onRelease when user release"); 


} 


System.out.println("call onRelease when user release"); 


onRelease (false); 

if (mPtrIndicator.hasMovedRfterPressedDown()) { 
sendCancelEvent (); 
return true; 


} 
return dispatchTouchEventSupper (e); 
pt } 
case MotionEvent.ACTION DOWN: 
System.out .println(" 按 下 ..."); 
mHasSendCancelEvent = false; 
mptrIindicator.onPressDown (e.getX(), e.getY()); 


mScrollChecker .abortIfWorking(); 


mPreventForHorizontal = false; 


// The cancel event will be sent once the position is moved. 


// So let the event pass to children. 

// fix #93, #102 

return dispatchTouchEventSupper (e); 
case MotionEvent.ACTION MOVE: 
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System.out .println ("移动 ..."); 
if (pullRefresh) {//Toolbar 显示 


} 


mLastMoveEvent = e7 

mPtrIndicator.onMove (e.getX(), e.getY()); 
float offsetX = mptrIindicator.getOffsetXx(); 
float offsetY = mptrIindicator.getOffsetYy (); 


if (mDisableWhenHorizontalMove && !mPreventForHorizontal && 
(Math .abs (offsetX) > mPagingTouchSlop && Math.abs (offsetX) > 
Math.abs (offsetY))) { 

if (mPtrIndicator.isInStartPosition()) { 

mPreventForHorizontal = true; 

， 
’ 
if (mpPreventForHorizontal) { 

return dispatchTouchEventSupper (e); 


} 


boolean moveDown = offsetY > 0; 
boolean moveUp = !moveDown; 
boolean canMoveUp = mPtrIindicator.hasLeftStartPosition(); 


if (DEBUG) { 
boolean canMoveDown = mPtrHandler != null && mpPtrHandler. 
checkCanDoRefresh (this, mContent, mHeaderView); 
PtrCLog.v(LOG TAG, "ACTION MOVE: offsetY:%s, currentPos: %s, 
moveUp: %s, canMoveUp: %s, moveDown: %s: canMoveDown: %s", 
offsetyY, mptrIindicator. getCurrentPosY(), moveUp, 
canMoveUp, moveDown, canMoveDown); 


// disable move when header not reach top 

if (moveDown && mPtrHandler != null && !ImPtrHandler. 
checkCanDoRefresh (this, mContent, mHeaderView)) { 
return dispatchTouchEventSupper (e); 


if ((moveUp && canMoveUp) || moveDown) { 
// System.out.println(" 是 否 下 拉 刷 新 : 
"+pullRefresh+" 偏 移 量 是 多 少 :"+offsetY); 
movePos (offsetY) 7 
return true; 


return dispatchTouchEventSupper (e); 


} 


只 修改 了 一 行 代码 ， 当 action==MotionEvent.ACTION_MOVE 时 ， 先 判断 传 入 的 pullRefresh 


是 否 为 true。 


3. 顶部 添加 轮 播 
RecyclerView 的 头 部 和 底部 加 入 View， 前 面 已 经 介绍 过 了 ， 都 是 用 适配器 的 封装 类 
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RecyclerAdapterWithHF 进行 控制 。 从 效果 图 可 以 看 出 ， 轮 播 的 View 是 加 入 到 头 部 的 ， 找 到 
RecyclerAdapterWithHF 类 ， 查 看 源 代码 即 可 。 


步骤 01& 需要 一 个 保存 View 的 集合 ， 其 实 使 用 一 个 变量 也 行 ， 因 为 只 有 一 个 轮 播 View。 





private List<View> mCarouse = new RrrayList<View> () ;// 保 存 轮 播 View 
// 可 以 添加 轮 播 view 
Public void addCarouse (View view){ 

mCarouse.add (view) 


} 
步 又 024 定义 一 个 常量 ， 用 于 判断 类 型 : 





public static final int TYPE CAROUSE = 7900; 
步骤 034 在 getltemViewType 中 添加 轮 播 的 类 型 


@Override 
public final int getItemViewType(int position) { 
// check what type our position is, based on the assumption that the 
// order is headers > items > footers 
if (isHeader (position)) { 
return TYPE HEADER; 
} else if (mCarouse.size()>0ggmHeaders.size()==position){ 
/ /判断 集合 个 数 &gposition==0， 这 时 mHeaders 中 还 没有 值 
return TYPE CAROUSE; 
}else if (isFooter(position)) { 
return TYPE FOOTER; 
} 
int type = getItemViewTypeHF (getRealPosition (Position) 
if (type TYPE HEADER || type == TYPE FOOTER|| type == TYPE CAROUSE) { 
throw new IllegalArgumentException("Item type cannot equal " + 
TYPE HEADER + " Or "+ TYPE FOOTER); 
return type; 






步骤 044 onCreateViewHolder 也 要 修改 一 下 , 就 是 在 让 中 多 加 了 一 个 &&。 无 论 是 头 部 或 底部 
轮 播 的 View ， 都 添加 到 FrameLayout 中 。 


@Override 
Public final RecyclerView.ViewHolder onCreateViewHolder (ViewGroup viewGroup, 
int type) { 
// if our position is one of our items (this comes from 
// getItemViewType (int position) below) 
if (type != TYPE HEADER && type != TYPE FOOTER && type != TYPE CAROUSE) { 
ViewHolder vh = onCreateViewHolderHF (viewGroup, type); 
return vh; 
// else we have a header/footer 
Ege 
// create a new framelayout, or inflate from a resource 
FrameLayout frameLayout = new FrameLayout (viewGroup .getContext ()); 
// make sure it fills the space 
frameLayout .setLayoutParams (new ViewGroup.LayoutParams (ViewGroup. 
LayoutParams .MATCH PARENT, ViewGroup.LayoutParams .MATCH PARENT)); 
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return new HeaderFooterViewHolder (frameLayout); 





步骤 05Q onBindViewHolder 为 项 目 绑 定数 据 ， 其 实 就 是 第 四 步 返 回 的 ItemView 绑 定数 据 。 


QOverride 
Public final void onBindViewHolder (final RecyclerView.ViewHolder vh, int 
position){ 
// check what type of view our position is 
if (isHeader (Position)) { 
View v = mHeaders.get (Position) 
// add our view to a header view and display it 
prepareHeaderFooter ((HeaderFooterViewHolder) vh, v); 
}else if(mCarouse.size()>0&&position==mHeaders.size())1{ 
// 这 时 mHeaders.size() 值 为 0 
//System.out .println ("有 多 少 个 头 View:"+mHeaders .size() +" 值 等 于 多 少 :"+ (mHeaders. 
size()-1)); 
View v = mCarouse.get (mHeaders.size());// 取 出 轮 播 的 View 
PrepareHeaderFooter ((HeaderFooterViewHolder) vh, v); 
} else if (isFooter(position)) { 
View v = mFooters.get (position - getItemCountHF () - mHeaders.size()); 
// add our view to a footer view and display it 
PrepareHeaderFooter ((HeaderFooterViewHolder) vh, v); 
} else { 
vh .itemView.setOnClickListener (new MyOnClickListener (vh)); 
vh.itemView.setOnLongClickListener (new MyOnLongClickListener (vh)); 
// it's one of our items, display as required 
onBindViewHolderHF (vh, getRealPosition(position)); 


步骤 064 从 第 五 步 看 到 头 部 或 底部 轮 播 的 View, 最 终 都 会 调用 prepareHeaderFooter 方法 。 查 
看 这 个 方法 的 源 代 码 ， 其 实 就 是 将 类 型 对 应 的 View 添加 到 Item 中 。 


Private void prepareHeaderFooter (HeaderFooterViewHolder vh, View view) { 
// if it's a staggered grid, span the whole layout 
if (mManagerType == TYPE MANAGER STAGGERED GRID) { 
StaggeredGridLayoutManager.LayoutParams layoutParams = new 
StaggeredGridLayoutManager.LayoutParams 
(ViewGroup .LayoutParams .MATCH PARENT,ViewGroup.LayoutParams. 
WRAP CONTENT) 
layoutParams.setFullSpan (true) 7 
vh.itemView.setLayoutParams (1ayoutParams) 


// if the view already belongs to another layout, remove it 
if (view.getParent() != null) { 

((ViewGroup) view.getParent()).removeView (view); 
| 


// empty out our FrameLayout and replace with our header/footer 
vh.base.removeAllViews () 7 
vh.base.addView (view); 

证 区 


